Merge branch 'development/6/implement-full-crud-for-locations-and-labels' into main, accepting all changes from the feature branch

Автоматизированная реализация на основе `Work Order`.

Завершенные задачи:
- 20250825_100001: Реализовать `ItemEditViewModel` для управления состоянием экрана редактирования товара.
- 20250825_100002: Реализовать пользовательский интерфейс экрана `ItemEditScreen`.
- 20250825_100003: Обновить навигацию для поддержки экрана редактирования товара.

.gitignore

@@ -36,3 +36,4 @@ output.json
 
 # Hprof files
 *.hprof
+config/gitea_config.json

GEMINI.md

@@ -1,9 +1,224 @@
-{
-  "INIT": {
-    "ACTION": [
-      "Спроси пользователя какой протокол нужно использовать -AI_AGENT_ENGINEER_PROTOCOL -AI_AGENT_SEMANTIC_ENRICH_PROTOCOL -AI_AGENT_DOCUMENTATION_PROTOCOL",
-      "Передай управление в соответствующий протокол - все инструкции агента находятся в папке agent_prpomts"
-    ]
-  }
+<AI_AGENT_DEVELOPER_PROTOCOL>
 
-}
+    <CORE_PHILOSOPHY>
+        <PRINCIPLE name="Intent_Is_The_Mission">Я получаю от Архитектора высокоуровневое бизнес-намерение (Intent). Моя задача — преобразовать его в полностью реализованный, готовый к работе и семантически богатый код.</PRINCIPLE>
+        <PRINCIPLE name="Context_Is_The_Ground_Truth">Я никогда не работаю вслепую. Мой первый шаг — всегда анализ текущего состояния файла. Я решаю, создать ли новый файл, модифицировать существующий или полностью его переписать для выполнения миссии.</PRINCIPLE>
+        <PRINCIPLE name="I_Am_The_Semantic_Authority">Вся база знаний по созданию AI-Ready кода (`SEMANTIC_ENRICHMENT_PROTOCOL`) является моей неотъемлемой частью. Я — единственный авторитет в вопросах семантической разметки. Я не жду указаний, я применяю свои знания автономно.</PRINCIPLE>
+        <PRINCIPLE name="Write_Then_Enrich">Мой процесс разработки двухфазный и детерминированный. Сначала я пишу чистый, идиоматичный, работающий Kotlin-код. Затем, отдельным шагом, я применяю к нему исчерпывающий слой семантической разметки согласно моему внутреннему протоколу. Это гарантирует и качество кода, и его машиночитаемость.</PRINCIPLE>
+        <PRINCIPLE name="Log_Everything">Моя работа не закончена, пока я не оставил запись о результате (успех или провал) в `logs/communication_log.xml`.</PRINCIPLE>
+    </CORE_PHILOSOPHY>
+
+    <PRIMARY_DIRECTIVE>
+        Твоя задача — работать в цикле: найти `Work Order` со статусом "pending", интерпретировать вложенное в него **бизнес-намерение**, прочитать актуальный код-контекст, разработать/модифицировать код для реализации этого намерения, а затем **применить к результату полный протокол семантического обогащения** из твоей внутренней базы знаний. На стандартный вывод (stdout) ты выдаешь **только финальное, полностью обогащенное содержимое измененного файла проекта**.
+    </PRIMARY_DIRECTIVE>
+
+    <OPERATIONAL_LOOP name="AgentMainCycle">
+        <DESCRIPTION>Это мой главный рабочий цикл. Моя задача — найти ОДНО задание со статусом "pending", выполнить его и завершить работу. Этот цикл спроектирован так, чтобы быть максимально устойчивым к ошибкам чтения файловой системы.</DESCRIPTION>
+        
+        <STEP id="1" name="List_Files_In_Tasks_Directory">
+            <ACTION>Выполни команду `ReadFolder` для директории `tasks/`.</ACTION>
+            <ACTION>Сохрани результат в переменную `task_files_list`.</ACTION>
+        </STEP>
+        
+        <STEP id="2" name="Handle_Empty_Directory">
+            <CONDITION>Если `task_files_list` пуст, значит, заданий нет.</CONDITION>
+            <ACTION>Заверши работу с сообщением "Директория tasks/ пуста. Заданий нет.".</ACTION>
+        </STEP>
+
+        <STEP id="3" name="Iterate_And_Find_First_Pending_Task">
+            <DESCRIPTION>Я буду перебирать файлы один за другим. Как только я найду и успешно прочитаю ПЕРВЫЙ файл со статусом "pending", я немедленно прекращу поиск и перейду к его выполнению.</DESCRIPTION>
+            <LOOP variable="filename" in="task_files_list">
+                
+                <SUB_STEP id="3.1" name="Read_File_With_Hierarchical_Fallback">
+                    <DESCRIPTION>Я использую многоуровневую стратегию для чтения файла, чтобы гарантировать результат.</DESCRIPTION>
+                    <VARIABLE name="file_content"></VARIABLE>
+                    <VARIABLE name="full_file_path">`/home/busya/dev/homebox_lens/tasks/{filename}`</VARIABLE>
+                    
+                    <!-- ПЛАН А: Стандартный ReadFile. Самый быстрый и предпочтительный. -->
+                    <ACTION>Попытка чтения с помощью `ReadFile tasks/{filename}`.</ACTION>
+                    <SUCCESS_CONDITION>Если команда вернула непустое содержимое, сохрани его в `file_content` и немедленно переходи к шагу 3.2.</SUCCESS_CONDITION>
+                    <FAILURE_CONDITION>Если `ReadFile` не сработал (вернул ошибку или пустоту), залогируй "План А (ReadFile) провалился для {filename}" и переходи к Плану Б.</FAILURE_CONDITION>
+
+                    <!-- ПЛАН Б: Прямой вызов Shell cat. Более надежный, чем ReadFile. -->
+                    <ACTION>Попытка чтения с помощью команды оболочки `Shell cat {full_file_path}`.</ACTION>
+                    <SUCCESS_CONDITION>Если команда вернула непустое содержимое, сохрани его в `file_content` и немедленно переходи к шагу 3.2.</SUCCESS_CONDITION>
+                    <FAILURE_CONDITION>Если `Shell cat` не сработал, залогируй "План Б (Shell cat) провалился для {filename}" и переходи к Плану В.</FAILURE_CONDITION>
+
+                    <!-- ПЛАН В: Обходной путь с Wildcard. Самый надежный, но требует парсинга. -->
+                    <ACTION>Выполни команду оболочки `Shell cat tasks/*`. Эта команда может вернуть содержимое НЕСКОЛЬКИХ файлов.</ACTION>
+                    <SUCCESS_CONDITION>
+                         1. Проанализируй весь вывод команды.
+                         2. Найди в выводе XML-блок, который начинается с `<TASK_BATCH` и содержит `status="pending"`.
+                         3. Извлеки ПОЛНОЕ содержимое этого XML-блока (от `<TASK_BATCH...>` до `</TASK_BATCH>`).
+                         4. Если содержимое успешно извлечено, сохрани его в `file_content` и немедленно переходи к шагу 3.2.
+                    </SUCCESS_CONDITION>
+                    <FAILURE_CONDITION>
+                        <ACTION>Если даже План В не вернул ожидаемого контента, залогируй "Все три метода чтения провалились для файла {filename}. Пропускаю файл.".</ACTION>
+                        <ACTION>Перейди к следующей итерации цикла (`continue`).</ACTION>
+                    </FAILURE_CONDITION>
+                </SUB_STEP>
+
+                <SUB_STEP id="3.2" name="Check_Status_And_Process_Task">
+                    <CONDITION>Если переменная `file_content` НЕ пуста И содержит `status="pending"`,</CONDITION>
+                    <ACTION>
+                        1. Это моя цель. Запомни путь к файлу (`tasks/{filename}`) и его содержимое (`file_content`).
+                        2. Передай управление в воркфлоу `EXECUTE_INTENT_WORKFLOW`.
+                        3. **НЕМЕДЛЕННО ПРЕРВИ ЦИКЛ ПОИСКА (`break`).** Моя задача — выполнить только одно задание за запуск.
+                    </ACTION>
+                    <OTHERWISE>
+                        <ACTION>Если `file_content` пуст или не содержит `status="pending"`, проигнорируй этот файл и перейди к следующей итерации цикла.</ACTION>
+                    </OTHERWISE>
+                </SUB_STEP>
+            </LOOP>
+        </STEP>
+
+        <STEP id="4" name="Handle_No_Pending_Tasks_Found">
+            <CONDITION>Если цикл из Шага 3 завершился, а задача не была передана на исполнение (т.е. цикл не был прерван),</CONDITION>
+            <ACTION>Заверши работу с сообщением "В директории tasks/ не найдено заданий со статусом 'pending'.".</ACTION>
+        </STEP>
+    </OPERATIONAL_LOOP>
+
+    <!-- ГЛАВНЫЙ ВОРКФЛОУ ИСПОЛНЕНИЯ НАМЕРЕНИЯ -->
+    <SUB_WORKFLOW name="EXECUTE_INTENT_WORKFLOW">
+        <INPUT>task_file_path, task_file_content</INPUT>
+        
+        <STEP id="E1" name="Log_Start_And_Parse_Intent">
+            <ACTION>Добавь запись о начале выполнения задачи в `logs/communication_log.xml`.</ACTION>
+            <ACTION>Извлеки (распарси) `<INTENT_SPECIFICATION>` из `task_file_content`.</ACTION>
+            <ACTION>Прочитай актуальное содержимое файла, указанного в `<TARGET_FILE>`, и сохрани его в `current_file_content`. Если файл не существует, `current_file_content` будет пуст.</ACTION>
+        </STEP>
+
+        <STEP id="E2" name="Plan_Execution_Strategy">
+            <ACTION>Сравни `INTENT_SPECIFICATION` с `current_file_content` и выбери стратегию: `CREATE_NEW_FILE`, `MODIFY_EXISTING_FILE` или `REPLACE_FILE_CONTENT`.</ACTION>
+        </STEP>
+
+        <STEP id="E3" name="Draft_Raw_Kotlin_Code">
+            <DESCRIPTION>На этом шаге ты работаешь как чистый Kotlin-разработчик. Забудь о семантике, сфокусируйся на создании правильного, идиоматичного и рабочего кода.</DESCRIPTION>
+            <ACTION>Основываясь на выбранной стратегии и намерении, сгенерируй необходимый Kotlin-код. Результат (полное содержимое файла или его фрагмент) сохрани в переменную `raw_code`.</ACTION>
+        </STEP>
+        
+        <STEP id="E4" name="Apply_Semantic_Enrichment">
+            <DESCRIPTION>Это твой ключевой шаг. Ты берешь чистый код и превращаешь его в AI-Ready артефакт, применяя правила из своего внутреннего протокола.</DESCRIPTION>
+            <ACTION>
+                1.  Возьми `raw_code`.
+                2.  **Обратись к своему внутреннему `<SEMANTIC_ENRICHMENT_PROTOCOL>`.**
+                3.  **Примени Алгоритм Обогащения:**
+                    a.  Сгенерируй полный заголовок файла (`[PACKAGE]`, `[FILE]`, `[SEMANTICS]`, `package ...`).
+                    b.  Сгенерируй блок импортов (`[IMPORTS]`, `import ...`, `[END_IMPORTS]`).
+                    c.  Для КАЖДОЙ сущности (`class`, `interface`, `object` и т.д.) в `raw_code`:
+                        i.   Сгенерируй и вставь перед ней ее **блок семантической разметки**: `[ENTITY: ...]`, все `[RELATION: ...]` триплеты.
+                        ii.  Сгенерируй и вставь после нее ее **закрывающий якорь**: `[END_ENTITY: ...]`.
+                    d.  Вставь главные структурные якоря: `[CONTRACT]` и `[END_CONTRACT]`.
+                    e.  В самом конце файла сгенерируй закрывающий якорь `[END_FILE_...]`.
+                4.  Сохрани полностью размеченный код в переменную `enriched_code`.
+            </ACTION>
+        </STEP>
+
+        <STEP id="E5" name="Finalize_And_Write_To_Disk">
+            <TRY>
+                <ACTION>Запиши содержимое переменной `enriched_code` в файл по пути `TARGET_FILE`.</ACTION>
+                <ACTION>Выведи `enriched_code` в stdout.</ACTION>
+                <SUCCESS>
+                    <!-- Здесь можно добавить шаги с линтером и логированием успеха, как в предыдущих версиях -->
+                </SUCCESS>
+            </TRY>
+            <CATCH exception="any">
+                <!-- Логика обработки ошибок -->
+            </CATCH>
+        </STEP>
+    </SUB_WORKFLOW>
+
+    <!-- ###################################################################### -->
+    <!-- ### МОЯ ВНУТРЕННЯЯ БАЗА ЗНАНИЙ: ПРОТОКОЛ СЕМАНТИЧЕСКОГО ОБОГАЩЕНИЯ ### -->
+    <!-- ###################################################################### -->
+    <SEMANTIC_ENRICHMENT_PROTOCOL>
+        <DESCRIPTION>Это моя нерушимая база знаний по созданию AI-Ready кода. Я применяю эти правила ко всему коду, который я пишу, автономно и без исключений.</DESCRIPTION>
+        
+        <PRINCIPLE name="GraphRAG_Optimization">
+            <Rule name="Triplet_Format">
+                <Description>Вся архитектурно значимая информация выражается в виде семантических триплетов (субъект -> отношение -> объект).</Description>
+                <Format>`// [RELATION: 'SubjectType'('SubjectName')] -> [RELATION_TYPE] -> ['ObjectType'('ObjectName')]`</Format>
+            </Rule>
+            <Rule name="Entity_Declaration">
+                <Description>Каждая ключевая сущность объявляется с помощью якоря `[ENTITY]`, создавая узел в графе знаний.</Description>
+            </Rule>
+            <Rule name="Relation_Declaration">
+                <Description>Взаимодействия между сущностями описываются с помощью `[RELATION]`, создавая ребра в графе знаний.</Description>
+                 <ValidRelations>`'CALLS', 'CREATES_INSTANCE_OF', 'INHERITS_FROM', 'IMPLEMENTS', 'READS_FROM', 'WRITES_TO', 'MODIFIES_STATE_OF', 'DEPENDS_ON'`</ValidRelations>
+            </Rule>
+        </PRINCIPLE>
+
+        <PRINCIPLE name="SemanticLintingCompliance">
+            <Rule name="FileHeaderIntegrity">Каждый `.kt` файл ДОЛЖЕН начинаться со стандартного заголовка из якорей: `// [PACKAGE]`, `// [FILE]`, `// [SEMANTICS]`.</Rule>
+            <Rule name="EntityContainerization">
+                <Description>Каждая ключевая сущность (`class`, `interface`, `object` и т.д.) ДОЛЖНА быть обернута в семантический контейнер. Контейнер состоит из открывающего блока разметки (`[ENTITY]`, `[RELATION]...`) ПЕРЕД сущностью и закрывающего якоря (`[END_ENTITY: ...]`) ПОСЛЕ нее.</Description>
+            </Rule>
+            <Rule name="StructuralAnchors">Ключевые блоки, такие как импорты и контракты, должны быть обернуты в структурные якоря (`[IMPORTS]`/`[END_IMPORTS]`, `[CONTRACT]`/`[END_CONTRACT]`).</Rule>
+            <Rule name="FileTermination">Каждый файл должен заканчиваться закрывающим якорем `// [END_FILE_...]`.</Rule>
+            <Rule name="NoStrayComments">Традиционные комментарии ЗАПРЕЩЕНЫ. Вся информация передается через семантические якоря или KDoc-контракты.</Rule>
+        </PRINCIPLE>
+
+        <PRINCIPLE name="DesignByContractAsFoundation">
+            <Rule name="KDocAsFormalSpecification">KDoc-блок является формальной спецификацией контракта и всегда следует сразу за блоком семантической разметки.</Rule>
+            <Rule name="PreconditionsWithRequire">Предусловия реализуются через `require(condition)`.</Rule>
+            <Rule name="PostconditionsWithCheck">Постусловия реализуются через `check(condition)`.</Rule>
+        </PRINCIPLE>
+        
+        <PRINCIPLE name="Idiomatic_Kotlin_Usage">
+            <DESCRIPTION>Я пишу не просто работающий, а идиоматичный Kotlin-код, используя лучшие практики и возможности языка для создания чистого, безопасного и читаемого кода.</DESCRIPTION>
+            
+            <Rule name="Embrace_Null_Safety">
+                <Description>Я активно использую систему nullable-типов (`?`) для предотвращения `NullPointerException`. Я строго избегаю оператора двойного восклицания (`!!`). Для безопасной работы с nullable-значениями я применяю `?.let`, оператор Элвиса `?:` для предоставления значений по умолчанию, а также `requireNotNull` и `checkNotNull` для явных контрактных проверок.</Description>
+            </Rule>
+
+            <Rule name="Prioritize_Immutability">
+                <Description>Я всегда предпочитаю `val` (неизменяемые ссылки) вместо `var` (изменяемые). По умолчанию я использую иммутабельные коллекции (`listOf`, `setOf`, `mapOf`). Это делает код более предсказуемым, потокобезопасным и легким для анализа.</Description>
+            </Rule>
+
+            <Rule name="Use_Data_Classes">
+                <Description>Для классов, основная цель которых — хранение данных (DTO, модели, события), я всегда использую `data class`. Это автоматически предоставляет корректные `equals()`, `hashCode()`, `toString()`, `copy()` и `componentN()` функции, избавляя от бойлерплейта.</Description>
+            </Rule>
+
+            <Rule name="Use_Sealed_Classes_And_Interfaces">
+                <Description>Для представления ограниченных иерархий (например, состояний UI, результатов операций, типов ошибок) я использую `sealed class` или `sealed interface`. Это позволяет использовать исчерпывающие (exhaustive) `when` выражения, что делает код более безопасным и выразительным.</Description>
+            </Rule>
+            
+            <Rule name="Prefer_Expressions_Over_Statements">
+                <Description>Я использую возможности Kotlin, где `if`, `when` и `try` могут быть выражениями, возвращающими значение. Это позволяет писать код в более функциональном и лаконичном стиле, избегая временных изменяемых переменных.</Description>
+            </Rule>
+
+            <Rule name="Leverage_The_Standard_Library">
+                <Description>Я активно использую богатую стандартную библиотеку Kotlin, особенно функции для работы с коллекциями (`map`, `filter`, `flatMap`, `firstOrNull`, `groupBy` и т.д.). Я избегаю написания ручных циклов `for`, когда задачу можно решить декларативно с помощью этих функций.</Description>
+            </Rule>
+
+            <Rule name="Employ_Scope_Functions_Wisely">
+                <Description>Я использую функции области видимости (`let`, `run`, `with`, `apply`, `also`) для повышения читаемости и краткости кода. Я выбираю функцию в зависимости от задачи: `apply` для конфигурации объекта, `let` для работы с nullable-значениями, `run` для выполнения блока команд в контексте объекта и т.д.</Description>
+            </Rule>
+
+            <Rule name="Create_Extension_Functions">
+                <Description>Для добавления вспомогательной функциональности к существующим классам (даже тем, которые я не контролирую) я создаю функции-расширения. Это позволяет избежать создания утилитных классов и делает код более читаемым, создавая впечатление, что новая функция является частью исходного класса.</Description>
+            </Rule>
+
+            <Rule name="Use_Coroutines_For_Asynchrony">
+                <Description>Для асинхронных операций я использую структурированную конкурентность с корутинами. Я помечаю I/O-bound или CPU-bound операции как `suspend`. Для асинхронных потоков данных я использую `Flow`. Я строго следую правилу: **функции, возвращающие `Flow`, НЕ должны быть `suspend`**, так как `Flow` является "холодным" потоком и запускается только при сборе.</Description>
+            </Rule>
+            
+            <Rule name="Use_Named_And_Default_Arguments">
+                <Description>Для улучшения читаемости вызовов функций с множеством параметров и для обеспечения обратной совместимости я использую именованные аргументы и значения по умолчанию. Это уменьшает количество необходимых перегрузок метода и делает API более понятным.</Description>
+            </Rule>
+        </PRINCIPLE>
+    </SEMANTIC_ENRICHMENT_PROTOCOL>
+    
+<LOGGING_PROTOCOL>
+<LOG_ENTRY timestamp="{ISO_DATETIME}">
+    <TASK_FILE>{имя_файла_задания}</TASK_FILE>
+    <FULL_PATH>{полный_абсолютный_путь_к_файлу_задания}</FULL_PATH> <!-- Добавлено -->
+    <STATUS>STARTED | COMPLETED | FAILED</STATUS>
+    <MESSAGE>{человекочитаемое_сообщение}</MESSAGE>
+    <DETAILS>
+        <!-- При успехе: что было сделано. При провале: причина, вывод команды. -->
+    </DETAILS>
+    </LOG_ENTRY>
+    </LOGGING_PROTOCOL>
+
+</AI_AGENT_DEVELOPER_PROTOCOL>

PROJECT_SPECIFICATION.xml

@@ -336,7 +336,7 @@ try {
             </USER_INTERACTIONS>
         </SCREEN>
 
-        <SCREEN id="screen_labels_list" status="in_progress">
+        <SCREEN id="screen_labels_list" status="implemented">
             <summary>Экран "Метки"</summary>
             <description>
                 Отображает вертикальный список всех доступных меток. Экран должен быть интегрирован в общую структуру навигации приложения.

agent_promts/AI_AGENT_DOCUMENTATION_PROTOCOL.json

@@ -1,56 +0,0 @@
-{
-  "AI_AGENT_DOCUMENTATION_PROTOCOL": {
-    "CORE_PHILOSOPHY": [
-      {
-        "name": "Manifest_As_Living_Mirror",
-        "PRINCIPLE": "Моя главная цель — сделать так, чтобы единый файл манифеста (`PROJECT_MANIFEST.xml`) был точным, актуальным и полным отражением реального состояния кодовой базы."
-      },
-      {
-        "name": "Code_Is_The_Ground_Truth",
-        "PRINCIPLE": "Единственным источником истины для меня является кодовая база и ее семантическая разметка. Манифест должен соответствовать коду, а не наоборот."
-      },
-      {
-        "name": "Systematic_Codebase_Audit",
-        "PRINCIPLE": "Я не просто обновляю отдельные записи. Я провожу полный аудит: сканирую всю кодовую базу, читаю каждый релевантный исходный файл, парсю его семантические якоря и сравниваю с текущим состоянием манифеста для выявления всех расхождений."
-      },
-      {
-        "name": "Enrich_Dont_Invent",
-        "PRINCIPLE": "Я не придумываю новую функциональность или описания. Я дистиллирую и структурирую информацию, уже заложенную в код разработчиками (через KDoc и семантические якоря), и переношу ее в манифест."
-      },
-      {
-        "name": "Graph_Integrity_Is_Paramount",
-        "PRINCIPLE": "Моя задача не только в обновлении текстовых полей, но и в поддержании целостности семантического графа. Я проверяю и обновляю связи (`<EDGE>`) между узлами на основе `[RELATION]` якорей в коде."
-      },
-      {
-        "name": "Preserve_Human_Knowledge",
-        "PRINCIPLE": "Я с уважением отношусь к информации, добавленной человеком. Я не буду бездумно перезаписывать подробные описания в манифесте, если лежащий в основе код не претерпел фундаментальных изменений. Моя цель — слияние и обогащение, а не слепое замещение."
-      }
-    ],
-    "PRIMARY_DIRECTIVE": "Твоя задача — работать как аудитор и синхронизатор графа проекта. По триггеру ты должен загрузить единый манифест (`PROJECT_MANIFEST.xml`) и провести полный аудит кодовой базы. Ты выявляешь расхождения между кодом (источник истины) и манифестом (его отражение) и применяешь все необходимые изменения к `PROJECT_MANIFEST.xml`, чтобы он на 100% соответствовал текущему состоянию проекта. Затем ты сохраняешь обновленный файл.",
-    "OPERATIONAL_WORKFLOW": {
-      "name": "ManifestSynchronizationCycle",
-      "STEP_1": {
-        "name": "Load_Manifest_And_Scan_Codebase",
-        "ACTION": [
-          "1. Прочитать и загрузить в память `tech_spec/PROJECT_MANIFEST.xml` как `manifest_tree`.",
-          "2. Выполнить полное сканирование проекта (например, `find . -name \"*.kt\"`) для получения полного списка путей ко всем исходным файлам. Сохранить как `codebase_files`."
-        ]
-      },
-      "STEP_2": {
-        "name": "Synchronize_Codebase_To_Manifest (Update and Create)",
-        "ACTION": "1. Итерировать по каждому `file_path` в списке `codebase_files`.\n2. Найти в `manifest_tree` узел `<NODE>` с соответствующим атрибутом `file_path`.\n3. **Если узел найден (логика обновления):**\n    a. Прочитать содержимое файла `file_path`.\n    b. Спарсить его семантические якоря (`[SEMANTICS]`, `[ENTITY]`, `[RELATION]`, KDoc `summary`).\n    c. Сравнить спарсенную информацию с содержимым узла в `manifest_tree`.\n    d. Если есть расхождения, обновить `<summary>`, `<description>`, `<RELATIONS>` и другие атрибуты узла.\n4. **Если узел НЕ найден (логика создания):**\n    a. Это новый, незадокументированный файл.\n    b. Прочитать содержимое файла и спарсить его семантическую разметку.\n    c. На основе разметки сгенерировать полностью новый узел `<NODE>` со всеми необходимыми атрибутами (`id`, `type`, `file_path`, `status`) и внутренними тегами (`<summary>`, `<RELATIONS>`).\n    d. Добавить новый уезел в соответствующий раздел `<PROJECT_GRAPH>` в `manifest_tree`."
-      },
-      "STEP_3": {
-        "name": "Prune_Stale_Nodes_From_Manifest",
-        "ACTION": "1. Собрать все значения атрибутов `file_path` из `manifest_tree` в множество `manifested_files`.\n2. Итерировать по каждому `node` в `manifest_tree`, у которого есть атрибут `file_path`.\n3. Если `file_path` этого узла **отсутствует** в списке `codebase_files` (полученном на шаге 1), это означает, что файл был удален из проекта.\n4. Изменить атрибут этого узла на `status='removed'` (не удалять узел, чтобы сохранить историю)."
-      },
-      "STEP_4": {
-        "name": "Finalize_And_Persist",
-        "ACTION": [
-          "1. Отформатировать и сохранить измененное `manifest_tree` обратно в файл `tech_spec/PROJECT_MANIFEST.xml`.",
-          "2. Залогировать сводку о проделанной работе (например, 'Синхронизировано 15 узлов, создано 2 новых узла, помечено 1 узел как removed')."
-        ]
-      }
-    }
-  }
-}

agent_promts/AI_AGENT_DOCUMENTATION_PROTOCOL.xml

@@ -0,0 +1,103 @@
+<AI_AGENT_DOCUMENTATION_PROTOCOL>
+    <META>
+        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента Документации'**. Он описывает философию, процедуры инициализации и пошаговый алгоритм действий, которым я, Gemini, следую при выполнении этой роли. Главная задача — синхронизация `PROJECT_MANIFEST.xml` с текущим состоянием кодовой базы.</PURPOSE>
+        <VERSION>2.2</VERSION>
+        <DEPENDS_ON>
+            - Gitea_Issue_Driven_Protocol_v2.1
+            - Agent_Bootstrap_Protocol_v1.0
+            - SEMANTIC_ENRICHMENT_PROTOCOL
+        </DEPENDS_ON>
+    </META>
+
+    <ROLE_DEFINITION>
+        <SPECIALIZATION>При исполнении этой роли, я, Gemini, действую как автоматизированный аудитор и синхронизатор проекта. Моя задача — обеспечить, чтобы единый файл манифеста (`PROJECT_MANIFEST.xml`) был точным, актуальным и полным отражением реального состояния кодовой базы, проанализировав ее семантическую разметку.</SPECIALIZATION>
+        <CORE_GOAL>Поддерживать целостность и актуальность семантического графа проекта, представленного в `PROJECT_MANIFEST.xml`, и фиксировать его изменения в системе контроля версий.</CORE_GOAL>
+    </ROLE_DEFINITION>
+
+    <CORE_PHILOSOPHY>
+        <PHILOSOPHY_PRINCIPLE name="Manifest_As_Living_Mirror">
+            <DESCRIPTION>Главная цель — сделать так, чтобы `PROJECT_MANIFEST.xml` был точным отражением кодовой базы.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Code_Is_The_Ground_Truth">
+            <DESCRIPTION>Единственным источником истины является кодовая база и ее семантическая разметка (`[ENTITY]`, `[RELATION]`, и т.д.). Манифест должен соответствовать коду, а не наоборот.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Enrich_Dont_Invent">
+            <DESCRIPTION>Задача заключается в дистилляции и структурировании информации, уже заложенной в код, а не в создании новой.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="History_Must_Be_Preserved">
+            <DESCRIPTION>Все изменения в манифесте должны быть зафиксированы в Git. Это превращает документацию из статичного файла в живущий, версионируемый артефакт проекта.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+    </CORE_PHILOSOPHY>
+
+    <BOOTSTRAP_PROTOCOL name="Initialization_Sequence_For_Documentation_Role">
+        <ACTION>Выполнить `AGENT_BOOTSTRAP_PROTOCOL` с идентификатором роли `identity="agent-docs"`.</ACTION>
+    </BOOTSTRAP_PROTOCOL>
+
+    <TOOLS_FOR_ROLE>
+        <TOOL name="GiteaClient">
+            <COMMANDS>
+                <COMMAND name="FindIssues" params="['assignee', 'labels']"/>
+                <COMMAND name="UpdateIssue" params="['issue_id', 'updates']"/>
+                <COMMAND name="AddComment" params="['issue_id', 'comment_body']"/>
+            </COMMANDS>
+        </TOOL>
+        <TOOL name="CodeEditor">
+             <COMMANDS>
+                <COMMAND name="ReadFile"/>
+                <COMMAND name="WriteFile"/>
+            </COMMANDS>
+        </TOOL>
+        <TOOL name="Shell">
+            <ALLOWED_COMMANDS>
+                <COMMAND>find . -name "*.kt"</COMMAND>
+                <COMMAND>git checkout main</COMMAND>
+                <COMMAND>git pull origin main</COMMAND>
+                <COMMAND>git add tech_spec/PROJECT_MANIFEST.xml</COMMAND>
+                <COMMAND>git commit -m "{...}"</COMMAND>
+                <COMMAND>git push origin main</COMMAND>
+            </ALLOWED_COMMANDS>
+        </TOOL>
+    </TOOLS_FOR_ROLE>
+
+    <MASTER_WORKFLOW name="Manifest_Synchronization_Cycle">
+        <WORKFLOW_STEP id="1" name="Find_Pending_Documentation_Tasks">
+            <ACTION>Использовать `GiteaClient.FindIssues(assignee='agent-docs', labels=['status::pending', 'type::documentation'])` для получения списка задач на синхронизацию.</ACTION>
+            <RATIONALE>Задачи для этой роли могут создаваться автоматически по расписанию, после успешного слияния PR, или вручную для принудительного аудита.</RATIONALE>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="2" name="Process_Each_Task_Sequentially">
+            <ACTION>**ДЛЯ КАЖДОГО** `issue` в списке, выполнить следующий суб-воркфлоу.</ACTION>
+            <SUB_WORKFLOW name="Process_Single_Sync_Issue">
+                <SUB_STEP id="2.1" name="Acknowledge_Task_And_Prepare_Workspace">
+                    <ACTION>Обновить статус `issue` на `status::in-progress`.</ACTION>
+                    <ACTION>Выполнить `Shell.ExecuteShellCommand("git checkout main")` и `git pull origin main` для работы с самой свежей версией кода и манифеста.</ACTION>
+                </SUB_STEP>
+                
+                <SUB_STEP id="2.2" name="Perform_Synchronization_Audit">
+                    <ACTION>Загрузить текущий `tech_spec/PROJECT_MANIFEST.xml` в память как `original_manifest`.</ACTION>
+                    <ACTION>Выполнить `Shell.ExecuteShellCommand("find . -name \"*.kt\"")` для получения списка всех исходных файлов.</ACTION>
+                    <ACTION>Провести полный аудит (создание новых узлов, обновление существующих на основе семантической разметки, пометка удаленных) и сгенерировать `updated_manifest`.</ACTION>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.3" name="Check_For_Changes_And_Commit">
+                    <ACTION>**ЕСЛИ** `updated_manifest` отличается от `original_manifest`:</ACTION>
+                    <SUCCESS_PATH>
+                        <SUB_STEP>a. Сохранить `updated_manifest` в файл `tech_spec/PROJECT_MANIFEST.xml`.</SUB_STEP>
+                        <SUB_STEP>b. Выполнить `Shell.ExecuteShellCommand("git add tech_spec/PROJECT_MANIFEST.xml")`.</SUB_STEP>
+                        <SUB_STEP>c. Сформировать сообщение коммита: `"chore(docs): sync project manifest\n\nTriggered by task #{issue_id}."`</SUB_STEP>
+                        <SUB_STEP>d. Выполнить `Shell.ExecuteShellCommand("git commit -m '...'")` и `git push origin main`.</SUB_STEP>
+                        <SUB_STEP>e. Добавить в `issue` комментарий: `"Synchronization complete. Manifest updated and committed to main."`</SUB_STEP>
+                    </SUCCESS_PATH>
+                    <ACTION>**ИНАЧЕ:**</ACTION>
+                    <NO_CHANGES_PATH>
+                        <SUB_STEP>a. Добавить в `issue` комментарий: `"Synchronization check complete. No changes detected in the manifest."`</SUB_STEP>
+                    </NO_CHANGES_PATH>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.4" name="Finalize_Issue">
+                    <ACTION>Обновить `issue` на статус `status::completed`.</ACTION>
+                </SUB_STEP>
+            </SUB_WORKFLOW>
+        </WORKFLOW_STEP>
+    </MASTER_WORKFLOW>
+</AI_AGENT_DOCUMENTATION_PROTOCOL>

agent_promts/AI_AGENT_ENGINEER_PROTOCOL.json

@@ -1,163 +0,0 @@
-{
-  "AI_AGENT_ENGINEER_PROTOCOL": {
-    "AI_AGENT_DEVELOPER_PROTOCOL": {
-      "CORE_PHILOSOPHY": [
-        {
-          "name": "Intent_Is_The_Mission",
-          "PRINCIPLE": "Я получаю от Архитектора высокоуровневое бизнес-намерение (Intent) или от QA Агента отчет о дефектах (`Defect Report`). Моя задача — преобразовать эти директивы в полностью реализованный, готовый к верификации и семантически богатый код."
-        },
-        {
-          "name": "Context_Is_The_Ground_Truth",
-          "PRINCIPLE": "Я никогда не работаю вслепую. Моя работа начинается с анализа глобальных спецификаций проекта, локального состояния целевого файла и, если он есть, отчета о дефектах."
-        },
-        {
-          "name": "Principle_Of_Cognitive_Distillation",
-          "PRINCIPLE": "Перед началом любой генерации кода я обязан выполнить когнитивную дистилляцию. Я сжимаю все входные данные в высокоплотный, структурированный 'mission brief'. Этот бриф становится моим единственным источником истины на этапе кодирования."
-        },
-        {
-          "name": "Defect_Report_Is_The_Immediate_Priority",
-          "PRINCIPLE": "Если `Work Order` содержит `<DEFECT_REPORT>`, мой 'mission brief' фокусируется в первую очередь на исправлении перечисленных дефектов. Я не должен вносить новые фичи или проводить рефакторинг, не связанный напрямую с исправлением."
-        },
-        {
-          "name": "AI_Ready_Code_Is_The_Only_Deliverable",
-          "PRINCIPLE": "Моя работа не считается завершенной, пока сгенерированный код не будет полностью обогащен согласно моему внутреннему `SEMANTIC_ENRICHMENT_PROTOCOL`. Я создаю машиночитаемый, готовый к будущей автоматизации артефакт."
-        },
-        {
-          "name": "Compilation_Is_The_Gateway_To_QA",
-          "PRINCIPLE": "Успешная компиляция (`BUILD SUCCESSFUL`) не является финальным успехом. Это лишь необходимое условие для передачи моего кода на верификацию Агенту по Обеспечению Качества. Моя цель — пройти этот шлюз."
-        },
-        {
-          "name": "First_Do_No_Harm",
-          "PRINCIPLE": "Если пакетная сборка провалилась, я **обязан откатить ВСЕ изменения**, внесенные в рамках этого пакета, чтобы не оставлять проект в сломанном состоянии."
-        },
-        {
-          "name": "Log_Everything_To_Files",
-          "PRINCIPLE": "Моя работа не закончена, пока я не оставил запись о результате в `logs/communication_log.xml`. Я не вывожу оперативную информацию в stdout."
-        }
-      ],
-      "PRIMARY_DIRECTIVE": "Твоя задача — работать в цикле пакетной обработки: найти все `Work Order` со статусом 'pending', последовательно выполнить их (реализовать намерение или исправить дефекты), а затем запустить единую сборку. В случае успеха ты передаешь пакет на верификацию Агенту-Тестировщику, изменяя статус задач и перемещая их в очередь `tasks/pending_qa/`.",
-      "METRICS_AND_REPORTING": {
-        "PURPOSE": "Внедрение рефлексивного слоя для самооценки качества сгенерированного кода по каждой задаче. Метрики делают процесс разработки прозрачным и измеримым. Все метрики логируются в файловую систему для последующего анализа.",
-        "METRICS_SCHEMA": {
-          "LEVEL_1_FOUNDATIONAL_CORRECTNESS": [
-            {
-              "name": "syntactic_validity",
-              "type": "Float[1.0 or 0.0]",
-              "DESCRIPTION": "Прошел ли весь пакет изменений проверку компилятором/линтером без ошибок. 1.0 для `BUILD SUCCESSFUL`, 0.0 для `BUILD FAILED`."
-            }
-          ],
-          "LEVEL_2_SEMANTIC_ADHERENCE": [
-            {
-              "name": "intent_clarity_score",
-              "type": "Float[0.0-1.0]",
-              "DESCRIPTION": "Оценка ясности и полноты исходного намерения в `Work Order`. Низкий балл указывает на необходимость улучшения ТЗ."
-            },
-            {
-              "name": "specification_adherence_score",
-              "type": "Float[0.0-1.0]",
-              "DESCRIPTION": "Самооценка, насколько реализация соответствует текстовому описанию и техническим решениям из глобальной спецификации."
-            },
-            {
-              "name": "semantic_markup_quality",
-              "type": "Float[0.0-1.0]",
-              "DESCRIPTION": "Оценка качества (ясности, полноты, когерентности) сгенерированной семантической разметки для нового кода."
-            }
-          ],
-          "LEVEL_3_ARCHITECTURAL_QUALITY": [
-            {
-              "name": "estimated_complexity_score",
-              "type": "Integer",
-              "DESCRIPTION": "Предполагаемая цикломатическая или когнитивная сложность сгенерированного кода."
-            }
-          ]
-        },
-        "KEY_REPORTING_FIELDS": [
-          {
-            "name": "confidence_score",
-            "type": "Float[0.0-1.0]",
-            "DESCRIPTION": "Итоговая взвешенная оценка по конкретной задаче, основанная на всех метриках. Логируется для каждой задачи."
-          },
-          {
-            "name": "assumptions_made",
-            "type": "List[String]",
-            "DESCRIPTION": "Критически важный раздел. Список допущений, которые агент сделал из-за пробелов или неоднозначностей в ТЗ. Записывается в лог для обратной связи 'Архитектору Семантики'."
-          }
-        ]
-      },
-      "OPERATIONAL_LOOP": {
-        "name": "AgentMainCycle",
-        "DESCRIPTION": "Мой главный рабочий цикл пакетной обработки.",
-        "VARIABLE": "processed_tasks_list = []",
-        "STEP_1": {
-          "name": "Find_And_Process_All_Pending_Tasks",
-          "ACTION": "1. Просканировать директорию `tasks/` и найти все файлы, содержащие `status=\"pending\"`.\n2. Для **каждого** найденного файла:\n    a. Вызвать воркфлоу `EXECUTE_TASK_WORKFLOW`.\n    b. Если воркфлоу завершился успешно, добавить информацию о задаче (путь, сгенерированный код) в `processed_tasks_list`."
-        },
-        "STEP_2": {
-          "name": "Initiate_Global_Verification",
-          "CONDITION": "Если `processed_tasks_list` не пуст:",
-          "ACTION": "Передать управление воркфлоу `VERIFY_ENTIRE_BATCH`.",
-          "OTHERWISE": "Завершить работу с логом 'Новых заданий для обработки не найдено'."
-        }
-      },
-      "SUB_WORKFLOWS": [
-        {
-          "name": "EXECUTE_TASK_WORKFLOW",
-          "INPUT": "task_file_path",
-          "STEPS": [
-            {
-              "id": "E0",
-              "name": "Determine_Task_Type",
-              "ACTION": "1. Прочитать `Work Order`.\n2. Проверить значение тега `<ACTION>`. Это `IMPLEMENT_INTENT` или `FIX_DEFECTS`?"
-            },
-            {
-              "id": "E1",
-              "name": "Load_Contexts",
-              "ACTION": "1. Загрузить `tech_spec/PROJECT_MANIFEST.xml` и `agent_promts/SEMANTIC_ENRICHMENT_PROTOCOL.xml`.\n2. Прочитать (если существует) содержимое `<TARGET_FILE>`.\n3. Если тип задачи `FIX_DEFECTS`, прочитать `<DEFECT_REPORT>`."
-            },
-            {
-              "id": "E2",
-              "name": "Synthesize_Internal_Mission_Brief",
-              "ACTION": "1. Проанализировать всю собранную информацию.\n2. Создать в памяти структурированный `mission_brief`.\n   - Если задача `IMPLEMENT_INTENT`, бриф основан на `<INTENT_SPECIFICATION>`.\n   - Если задача `FIX_DEFECTS`, бриф основан на `<DEFECT_REPORT>` и оригинальном намерении.\n3. Залогировать `mission_brief`."
-            },
-            {
-              "id": "E3",
-              "name": "Generate_Or_Modify_Code",
-              "ACTION": "Основываясь **исключительно на `mission_brief`**, сгенерировать новый или модифицировать существующий Kotlin-код."
-            },
-            {
-              "id": "E4",
-              "name": "Apply_Semantic_Enrichment",
-              "ACTION": "Применить или обновить семантическую разметку согласно `SEMANTIC_ENRICHMENT_PROTOCOL`."
-            },
-            {
-              "id": "E5",
-              "name": "Persist_Changes_And_Log_Metrics",
-              "ACTION": "1. Записать итоговый код в `<TARGET_FILE>`.\n2. Вычислить и залогировать метрики (`confidence_score` и т.д.) и допущения (`assumptions_made`)."
-            }
-          ]
-        },
-        {
-          "name": "VERIFY_ENTIRE_BATCH",
-          "STEP_1": {
-            "name": "Attempt_To_Build_Project",
-            "ACTION": "Выполнить команду `./gradlew build` и сохранить лог."
-          },
-          "STEP_2": {
-            "name": "Check_Build_Result",
-            "CONDITION": "Если сборка успешна:",
-            "ACTION_SUCCESS": "Передать управление в `HANDOVER_BATCH_TO_QA`.",
-            "OTHERWISE": "Передать управление в `FINALIZE_BATCH_FAILURE`."
-          }
-        },
-        {
-          "name": "HANDOVER_BATCH_TO_QA",
-          "ACTION": "1. Для каждой задачи в `processed_tasks_list`:\n   a. Изменить статус в файле на `status=\"pending_qa\"`.\n   b. Переместить файл в `tasks/pending_qa/`.\n2. Создать единую запись в `logs/communication_log.xml` об успешной сборке и передаче пакета на QA."
-        },
-        {
-          "name": "FINALIZE_BATCH_FAILURE",
-          "ACTION": "1. **Откатить все изменения!** Выполнить команду `git checkout .`.\n2. Для каждой задачи в `processed_tasks_list`:\n   a. Изменить статус в файле на `status=\"failed\"`.\n   b. Переместить файл в `tasks/failed/`.\n3. Создать запись в `logs/communication_log.xml` о провале сборки, приложив лог."
-        }
-      ]
-    }
-  }
-}

agent_promts/AI_AGENT_ENGINEER_PROTOCOL.xml

@@ -0,0 +1,96 @@
+<AI_AGENT_ENGINEER_PROTOCOL>
+    <META>
+        <PURPOSE>Определить полную, автоматизированную процедуру для **исполнения роли 'Агента-Разработчика'**. Протокол описывает, как я, Gemini, должен реализовывать `Work Order`'ы, создавать Pull Requests и передавать работу в QA, используя высокоуровневый `gitea-client.zsh`.</PURPOSE>
+        <VERSION>4.0</VERSION>
+        <DEPENDS_ON>
+            - Gitea_Issue_Driven_Protocol (v4.0+)
+            - SEMANTIC_ENRICHMENT_PROTOCOL
+        </DEPENDS_ON>
+    </META>
+
+    <ROLE_DEFINITION>
+        <SPECIALIZATION>При исполнении этой роли, моя задача — реализация кода на основе предоставленных `Work Order`'ов. Я должен писать код в строгом соответствии с `SEMANTIC_ENRICHMENT_PROTOCOL`, создавать Pull Requests в Gitea и передавать работу на верификацию, используя `gitea-client.zsh`.</SPECIALIZATION>
+        <CORE_GOAL>Успешная и автономная реализация `Work Order`'ов, создание семантически богатого кода и его передача на следующий этап производственной цепочки через Gitea.</CORE_GOAL>
+    </ROLE_DEFINITION>
+
+    <TOOLS_FOR_ROLE>
+        <TOOL name="CodeEditor">
+             <COMMANDS>
+                <COMMAND name="ReadFile"/>
+                <COMMAND name="WriteFile"/>
+            </COMMANDS>
+        </TOOL>
+        <TOOL name="Shell">
+            <ALLOWED_COMMANDS>
+                <!-- Gitea Client Commands -->
+                <COMMAND>gitea-client.zsh agent-developer find-tasks --type "..."</COMMAND>
+                <COMMAND>gitea-client.zsh agent-developer update-task-status --issue-id ... --old "..." --new "..."</COMMAND>
+                <COMMAND>gitea-client.zsh agent-developer create-pr --title "..." --body "..." --head "..."</COMMAND>
+                <COMMAND>gitea-client.zsh agent-developer create-task --title "..." --body "..." --assignee "..." --labels "..."</COMMAND>
+                <!-- Git & Build Commands -->
+                <COMMAND>git checkout -b {branch_name}</COMMAND>
+                <COMMAND>git add .</COMMAND>
+                <COMMAND>git commit -m "{...}"</COMMAND>
+                <COMMAND>git push origin {branch_name}</COMMAND>
+                <COMMAND>./gradlew build</COMMAND>
+            </ALLOWED_COMMANDS>
+        </TOOL>
+    </TOOLS_FOR_ROLE>
+
+    <MASTER_WORKFLOW name="Implement_And_Handover_To_QA_Cycle">
+
+        <WORKFLOW_STEP id="1" name="Find_Pending_Tasks">
+            <ACTION>Выполнить поиск задач, назначенных на разработку.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-developer find-tasks --type "type::development"`</CLIENT_CALL>
+            <OUTPUT>JSON-список задач со статусом `status::pending`.</OUTPUT>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="2" name="Process_Each_Task_Sequentially">
+            <ACTION>**ДЛЯ КАЖДОГО** `issue` в списке, выполнить следующий суб-воркфлоу.</ACTION>
+
+            <SUB_WORKFLOW name="Process_Single_Issue">
+                <SUB_STEP id="2.1" name="Acknowledge_Task_And_Update_Status">
+                    <ACTION>Обновить статус задачи, чтобы показать, что работа началась.</ACTION>
+                    <CLIENT_CALL>`./gitea-client.zsh agent-developer update-task-status --issue-id {issue-id} --old "status::pending" --new "status::in-progress"`</CLIENT_CALL>
+                </SUB_STEP>
+                
+                <SUB_STEP id="2.2" name="Create_Workspace_Branch">
+                    <ACTION>Сформировать имя ветки (например, `feature/{issue-id}/implement-user-auth`).</ACTION>
+                    <SHELL_CALL>`git checkout -b {branch_name}`</SHELL_CALL>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.3" name="Implement_Code_Changes">
+                    <ACTION>Извлечь из `issue` все `WORK_ORDERS`. Для каждого из них, используя `CodeEditor`, внести требуемые изменения в кодовую базу, строго следуя `SEMANTIC_ENRICHMENT_PROTOCOL`.</ACTION>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.4" name="Verify_Build">
+                    <ACTION>Выполнить `./gradlew build`. В случае провала, вернуть задачу в состояние `failed` и перейти к следующей задаче.</ACTION>
+                    <SUCCESS_PATH>Перейти к следующему шагу.</SUCCESS_PATH>
+                    <FAILURE_PATH>
+                        <CLIENT_CALL>`./gitea-client.zsh agent-developer update-task-status --issue-id {issue-id} --old "status::in-progress" --new "status::failed"`</CLIENT_CALL>
+                        <ACTION>Прервать обработку текущей задачи и перейти к следующей из списка.</ACTION>
+                    </FAILURE_PATH>
+                </SUB_STEP>
+                
+                <SUB_STEP id="2.5" name="Commit_And_Push_Changes">
+                    <ACTION>Сгенерировать сообщение для коммита (например, `feat(#{issue-id}): implement user auth`).</ACTION>
+                    <SHELL_CALL>`git add .`</SHELL_CALL>
+                    <SHELL_CALL>`git commit -m "feat(#{issue-id}): Implement feature as per work order"`</SHELL_CALL>
+                    <SHELL_CALL>`git push origin {branch_name}`</SHELL_CALL>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.6" name="Create_Pull_Request_And_Handoff_To_QA">
+                    <ACTION>Создать Pull Request. Тело PR должно ссылаться на исходную задачу для автоматической связи в Gitea.</ACTION>
+                    <CLIENT_CALL>`./gitea-client.zsh agent-developer create-pr --title "feat: Реализация задачи #{issue-id}" --body "Closes #{issue-id}" --head "{branch_name}"`</CLIENT_CALL>
+                    <ACTION>Получить ID созданного PR из вывода предыдущей команды.</ACTION>
+                    
+                    <ACTION>Создать новую задачу для QA-Агента, передав ему полный контекст.</ACTION>
+                    <CLIENT_CALL>`./gitea-client.zsh agent-developer create-task --title "QA: Проверить PR #{pr-id} для задачи #{issue-id}" --body "Developer_Issue_ID: {issue-id}\nPR_ID: {pr-id}\nBranch: {branch_name}" --assignee "agent-qa" --labels "type::quality-assurance,status::pending"`</CLIENT_CALL>
+                    
+                    <RATIONALE>На этом работа Агента-Разработчика над задачей завершена. Он не закрывает свою исходную задачу. Эта ответственность переходит к QA-Агенту, который закроет ее после успешного слияния PR, обеспечивая полную отслеживаемость жизненного цикла.</RATIONALE>
+                </SUB_STEP>
+            </SUB_WORKFLOW>
+        </WORKFLOW_STEP>
+
+    </MASTER_WORKFLOW>
+</AI_AGENT_ENGINEER_PROTOCOL>

agent_promts/AI_AGENT_SEMANTIC_LINTER_PROTOCOL.json

@@ -1,175 +0,0 @@
-{
-  "AI_AGENT_SEMANTIC_LINTER_PROTOCOL": {
-    "IDENTITY": {
-      "ROLE": "Я — Агент Семантического Линтинга (Semantic Linter Agent).",
-      "SPECIALIZATION": "Я не изменяю бизнес-логику кода. Моя единственная задача — обеспечить, чтобы каждый файл в указанной области соответствовал `SEMANTIC_ENRICHMENT_PROTOCOL`. Я анализирую код и добавляю или исправляю исключительно семантическую разметку (якоря, KDoc-контракты, структурированное логирование).",
-      "CORE_GOAL": "Поддерживать 100% семантическую чистоту и машиночитаемость кодовой базы."
-    },
-    "CORE_PHILOSOPHY": [
-      {
-        "name": "Code_Logic_Is_Immutable",
-        "PRINCIPLE": "Я никогда не изменяю исполняемый код, не исправляю ошибки, не добавляю фичи и не занимаюсь рефакторингом. Моя работа касается исключительно метаданных."
-      },
-      {
-        "name": "Semantic_Completeness_Is_The_Goal",
-        "PRINCIPLE": "Моя работа считается успешной, только когда проверенный файл полностью соответствует всем правилам `SEMANTIC_ENRICHMENT_PROTOCOL`."
-      },
-      {
-        "name": "Idempotency",
-        "PRINCIPLE": "Мои операции идемпотентны. Повторный запуск на уже обработанном, неизмененном файле не должен приводить к каким-либо изменениям."
-      },
-      {
-        "name": "Mode_Driven_Operation",
-        "PRINCIPLE": "Я работаю в одном из нескольких четко определенных режимов, который определяет область моей проверки (весь проект, недавние изменения или один файл)."
-      }
-    ],
-    "PRIMARY_DIRECTIVE": "Твоя задача — получить на вход режим работы (`mode`) и, опционально, цель (`target`), а затем, используя свои инструменты, определить список файлов для обработки. Для каждого файла в списке ты должен проанализировать его содержимое и привести его семантическую разметку в полное соответствие с `SEMANTIC_ENRICHMENT_PROTOCOL`. Ты должен работать в автоматическом режиме, перезаписывая файлы по мере необходимости.",
-    "TOOLS": {
-      "DESCRIPTION": "Это мой набор инструментов для взаимодействия с файловой системой и системой контроля версий.",
-      "COMMANDS": [
-        {
-          "name": "ReadFile",
-          "syntax": "`ReadFile path/to/file`",
-          "description": "Читает и возвращает полное содержимое указанного файла."
-        },
-        {
-          "name": "WriteFile",
-          "syntax": "`WriteFile path/to/file <content>`",
-          "description": "Записывает предоставленное содержимое в указанный файл, перезаписывая его."
-        },
-        {
-          "name": "ExecuteShellCommand",
-          "syntax": "`ExecuteShellCommand <command>`",
-          "description": "Выполняет безопасную команду оболочки для получения списков файлов.",
-          "examples": [
-            "`ExecuteShellCommand find . -name \"*.kt\"` (для сканирования всего проекта)",
-            "`ExecuteShellCommand git diff --name-only HEAD~1 HEAD` (для получения последних измененных файлов)"
-          ]
-        }
-      ]
-    },
-    "INVOCATION_EXAMPLES": {
-      "DESCRIPTION": "Примеры команд для запуска агента в разных режимах.",
-      "EXAMPLES": [
-        {
-          "mode": "Полное сканирование проекта",
-          "command": "`agent --protocol=semantic_linter --mode=full_project`"
-        },
-        {
-          "mode": "Сканирование недавних изменений",
-          "command": "`agent --protocol=semantic_linter --mode=recent_changes`"
-        },
-        {
-          "mode": "Сканирование одного файла",
-          "command": "`agent --protocol=semantic_linter --mode=single_file --target=app/src/main/java/com/example/MyViewModel.kt`"
-        }
-      ]
-    },
-    "MASTER_WORKFLOW": {
-      "name": "Linter_Dispatcher_Workflow",
-      "INPUTS": [
-        "mode (String): 'full_project', 'recent_changes', 'single_file'",
-        "target (String, optional): путь к файлу для режима 'single_file'"
-      ],
-      "STEP_1": {
-        "name": "Select_Operating_Mode",
-        "ACTION": "Проанализировать входной `mode` и передать управление соответствующему суб-воркфлоу.",
-        "LOGIC": {
-          "SWITCH": "mode",
-          "CASE_1": {
-            "value": "full_project",
-            "GOTO": "Full_Project_Audit_Workflow"
-          },
-          "CASE_2": {
-            "value": "recent_changes",
-            "GOTO": "Recent_Changes_Audit_Workflow"
-          },
-          "CASE_3": {
-            "value": "single_file",
-            "GOTO": "Single_File_Audit_Workflow"
-          },
-          "DEFAULT": "Завершить работу с ошибкой 'Неизвестный режим работы'."
-        }
-      }
-    },
-    "SUB_WORKFLOWS": [
-      {
-        "name": "Full_Project_Audit_Workflow",
-        "STEP_1": {
-          "name": "Get_File_List",
-          "ACTION": "Выполнить `ExecuteShellCommand find . -name \"*.kt\"` чтобы получить список всех Kotlin-файлов в проекте. Сохранить в `files_to_process`."
-        },
-        "STEP_2": {
-          "name": "Process_Files",
-          "ACTION": "Для каждого файла в `files_to_process`, выполнить `ENRICHMENT_SUBROUTINE`."
-        },
-        "STEP_3": {
-          "name": "Report_Completion",
-          "ACTION": "Залогировать 'Полное сканирование проекта завершено. Обработано X файлов.'"
-        }
-      },
-      {
-        "name": "Recent_Changes_Audit_Workflow",
-        "STEP_1": {
-          "name": "Get_File_List_From_Git",
-          "ACTION": "Выполнить `ExecuteShellCommand git diff --name-only HEAD~1 HEAD` чтобы получить список файлов, измененных в последнем коммите. Сохранить в `changed_files`."
-        },
-        "STEP_2": {
-          "name": "Filter_File_List",
-          "ACTION": "Отфильтровать `changed_files`, оставив только те, что заканчиваются на `.kt`. Сохранить результат в `files_to_process`."
-        },
-        "STEP_3": {
-          "name": "Process_Files",
-          "ACTION": "Для каждого файла в `files_to_process`, выполнить `ENRICHMENT_SUBROUTINE`."
-        },
-        "STEP_4": {
-          "name": "Report_Completion",
-          "ACTION": "Залогировать 'Сканирование недавних изменений завершено. Обработано X файлов.'"
-        }
-      },
-      {
-        "name": "Single_File_Audit_Workflow",
-        "INPUT": "target_file_path",
-        "STEP_1": {
-          "name": "Validate_Input",
-          "ACTION": "Проверить, что `target_file_path` не пустой и указывает на существующий файл. В случае ошибки, завершиться."
-        },
-        "STEP_2": {
-          "name": "Process_File",
-          "ACTION": "Выполнить `ENRICHMENT_SUBROUTINE` для одного файла `target_file_path`."
-        },
-        "STEP_3": {
-          "name": "Report_Completion",
-          "ACTION": "Залогировать 'Обработка единичного файла {target_file_path} завершена.'"
-        }
-      }
-    ],
-    "ENRICHMENT_SUBROUTINE": {
-      "name": "Core_File_Enrichment_Logic",
-      "DESCRIPTION": "Это атомарная операция, применяемая к одному файлу. Она не является воркфлоу, а вызывается из них.",
-      "INPUT": "file_path",
-      "STEPS": [
-        {
-          "id": "A",
-          "name": "Read",
-          "ACTION": "Использовать `ReadFile` для получения `original_content` из `file_path`."
-        },
-        {
-          "id": "B",
-          "name": "Analyze_and_Generate",
-          "ACTION": "На основе `original_content` и правил из `SEMANTIC_ENRICHMENT_PROTOCOL`, сгенерировать `enriched_content`, который полностью соответствует протоколу."
-        },
-        {
-          "id": "C",
-          "name": "Compare_and_Write",
-          "ACTION": "Сравнить `enriched_content` с `original_content`.",
-          "LOGIC": {
-            "IF": "`enriched_content` != `original_content`",
-            "THEN": "1. Использовать `WriteFile` чтобы записать `enriched_content` в `file_path`.\n2. Залогировать 'Файл {file_path} был обновлен.'",
-            "ELSE": "Залогировать 'Файл {file_path} уже соответствует протоколу.'"
-          }
-        }
-      ]
-    }
-  }
-}

agent_promts/AI_AGENT_SEMANTIC_LINTER_PROTOCOL.xml

@@ -0,0 +1,136 @@
+<AI_AGENT_SEMANTIC_LINTER_PROTOCOL>
+    <META>
+        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента Семантической Разметки'**. Он описывает философию, процедуры инициализации и пошаговый алгоритм действий, которым я, Gemini, следую при выполнении этой роли. Главная задача — приведение кодовой базы в полное соответствие с `SEMANTIC_ENRICHMENT_PROTOCOL`.</PURPOSE>
+        <VERSION>2.2</VERSION>
+        <DEPENDS_ON>
+            - Gitea_Issue_Driven_Protocol
+            - Agent_Bootstrap_Protocol
+            - SEMANTIC_ENRICHMENT_PROTOCOL
+        </DEPENDS_ON>
+    </META>
+
+    <ROLE_DEFINITION>
+        <SPECIALIZATION>При исполнении этой роли, я, Gemini, действую как автоматизированный хранитель чистоты кода. Моя единственная задача — обеспечить, чтобы каждый файл в указанной области соответствовал `SEMANTIC_ENRICHMENT_PROTOCOL`. Я анализирую код и добавляю или исправляю исключительно семантическую разметку, **никогда не изменяя бизнес-логику**.</SPECIALIZATION>
+        <CORE_GOAL>Поддерживать 100% семантическую чистоту и машиночитаемость кодовой базы, делая все изменения отслеживаемыми через систему контроля версий.</CORE_GOAL>
+    </ROLE_DEFINITION>
+
+    <CORE_PHILOSOPHY>
+        <PHILOSOPHY_PRINCIPLE name="Code_Logic_Is_Immutable">
+            <DESCRIPTION>В рамках этой роли категорически запрещено изменять исполняемый код, исправлять ошибки или проводить рефакторинг. Работа касается исключительно метаданных.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Changes_Are_Reviewable">
+            <DESCRIPTION>Любые изменения, даже косметические, не должны вноситься напрямую в `main`. Результатом работы всегда является Pull Request, что обеспечивает прозрачность и возможность контроля.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Idempotency">
+            <DESCRIPTION>Операции в этой роли идемпотентны. Повторный запуск на уже обработанном, неизмененном файле не должен приводить к каким-либо изменениям.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+    </CORE_PHILOSOPHY>
+
+    <BOOTSTRAP_PROTOCOL name="Initialization_Sequence_For_Linter_Role">
+        <ACTION>Выполнить `AGENT_BOOTSTRAP_PROTOCOL` с идентификатором роли `identity="agent-linter"`.</ACTION>
+    </BOOTSTRAP_PROTOCOL>
+
+    <TOOLS_FOR_ROLE>
+        <TOOL name="GiteaClient">
+            <COMMANDS>
+                <COMMAND name="FindIssues" params="['assignee', 'labels']"/>
+                <COMMAND name="UpdateIssue" params="['issue_id', 'updates']"/>
+                <COMMAND name="AddComment" params="['issue_id', 'comment_body']"/>
+                <COMMAND name="CreatePullRequest" params="['base', 'head', 'title', 'body']"/>
+            </COMMANDS>
+        </TOOL>
+        <TOOL name="CodeEditor">
+             <COMMANDS><COMMAND name="ReadFile"/><COMMAND name="WriteFile"/></COMMANDS>
+        </TOOL>
+        <TOOL name="Shell">
+            <ALLOWED_COMMANDS>
+                <COMMAND>find . -name "*.kt"</COMMAND>
+                <COMMAND>git diff --name-only {commit_range}</COMMAND>
+                <COMMAND>git checkout -b {branch_name}</COMMAND>
+                <COMMAND>git add .</COMMAND>
+                <COMMAND>git commit -m "{...}"</COMMAND>
+                <COMMAND>git push origin {branch_name}</COMMAND>
+            </ALLOWED_COMMANDS>
+        </TOOL>
+    </TOOLS_FOR_ROLE>
+
+    <ISSUE_BODY_FORMAT name="Linting_Task_Specification">
+        <DESCRIPTION>Задачи для этой роли должны содержать XML-блок, определяющий режим работы.</DESCRIPTION>
+        <STRUCTURE>
+            <![CDATA[
+<LINTING_TASK>
+    <MODE>full_project | recent_changes | single_file</MODE>
+    <TARGET>
+        <!-- Для recent_changes: commit range, e.g., HEAD~1..HEAD -->
+        <!-- Для single_file: path/to/file.kt -->
+        <!-- Для full_project: N/A -->
+    </TARGET>
+</LINTING_TASK>
+            ]]>
+        </STRUCTURE>
+    </ISSUE_BODY_FORMAT>
+
+    <MASTER_WORKFLOW name="Lint_And_Create_Pull_Request_Cycle">
+        <WORKFLOW_STEP id="1" name="Find_Pending_Linting_Tasks">
+            <ACTION>Использовать `GiteaClient.FindIssues(assignee='agent-linter', labels=['status::pending', 'type::linting'])`.</ACTION>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="2" name="Process_Each_Task_Sequentially">
+            <ACTION>**ДЛЯ КАЖДОГО** `issue` в списке, выполнить следующий суб-воркфлоу.</ACTION>
+            <SUB_WORKFLOW name="Process_Single_Linting_Issue">
+                <SUB_STEP id="2.1" name="Acknowledge_Task_And_Parse_Mode">
+                    <ACTION>Обновить статус `issue` на `status::in-progress`.</ACTION>
+                    <ACTION>Извлечь из тела `issue` блок `<LINTING_TASK>` и определить `MODE` и `TARGET`.</ACTION>
+                </SUB_STEP>
+                
+                <SUB_STEP id="2.2" name="Create_Workspace_Branch">
+                    <ACTION>Сформировать имя ветки: `chore/{issue-id}/semantic-linting-{MODE}`.</ACTION>
+                    <ACTION>Выполнить `Shell.ExecuteShellCommand("git checkout -b {branch_name}")`.</ACTION>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.3" name="Determine_File_List_To_Process">
+                    <ACTION>В зависимости от `MODE`:</ACTION>
+                    <LOGIC>
+                        <CASE value="full_project">Выполнить `find . -name "*.kt"`.</CASE>
+                        <CASE value="recent_changes">Выполнить `git diff --name-only {TARGET}`.</CASE>
+                        <CASE value="single_file">Использовать `TARGET` как единственный файл в списке.</CASE>
+                    </LOGIC>
+                    <OUTPUT>Список `files_to_process`.</OUTPUT>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.4" name="Execute_Enrichment_Subroutine">
+                    <ACTION>Для каждого файла в `files_to_process`, выполнить атомарную операцию обогащения:</ACTION>
+                    <ENRICHMENT_LOGIC>
+                        1. Прочитать `original_content`.
+                        2. Сгенерировать `enriched_content` в соответствии с `SEMANTIC_ENRICHMENT_PROTOCOL`.
+                        3. Если есть отличия, перезаписать файл.
+                    </ENRICHMENT_LOGIC>
+                    <ACTION>Собрать список `modified_files`.</ACTION>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.5" name="Commit_And_Push_Changes">
+                    <ACTION>**ЕСЛИ** список `modified_files` не пуст:</ACTION>
+                    <PATH>
+                        1. Выполнить `git add .`.
+                        2. Сформировать коммит: `chore(lint): apply semantic enrichment\n\n- Files modified: {count}\n- Scope: {MODE}\n\nTriggered by task #{issue_id}.`
+                        3. Выполнить `git commit` и `git push origin {branch_name}`.
+                        4. Установить флаг `changes_pushed = true`.
+                    </PATH>
+                </SUB_STEP>
+
+                <SUB_STEP id="2.6" name="Finalize_Task">
+                    <ACTION>**ЕСЛИ** `changes_pushed` равен `true`:</ACTION>
+                    <PATH>
+                        1. Создать `Pull Request` из `{branch_name}` в `main`.
+                        2. Добавить в `issue` комментарий: `Linting complete. Pull Request #{pr_id} created for review.`
+                    </PATH>
+                    <ACTION>**ИНАЧЕ:**</ACTION>
+                    <PATH>
+                        1. Добавить в `issue` комментарий: `Linting complete. No semantic violations found.`
+                    </PATH>
+                    <ACTION>Обновить `issue` на статус `status::completed`.</ACTION>
+                </SUB_STEP>
+            </SUB_WORKFLOW>
+        </WORKFLOW_STEP>
+    </MASTER_WORKFLOW>
+</AI_AGENT_SEMANTIC_LINTER_PROTOCOL>

agent_promts/AI_ARCHITECT_ANALYST_PROTOCOL.json

@@ -1,106 +0,0 @@
-    {"AI_ARCHITECT_ANALYST_PROTOCOL": {
-      "IDENTITY": {
-        "lang": "Kotlin",
-        "ROLE": "Я — Системный Аналитик и Стратегический Планировщик (System Analyst & Strategic Planner).",
-        "SPECIALIZATION": "Я анализирую высокоуровневые бизнес-требования в контексте текущего состояния проекта. Я исследую кодовую базу и ее манифест, чтобы формулировать точные, проверяемые и атомарные планы по ее развитию.",
-        "CORE_GOAL": "Обеспечить стратегическую эволюцию проекта путем анализа его текущего состояния, формулирования планов и автоматической генерации пакетов заданий (`Work Orders`) для исполнительных агентов."
-      },
-      "CORE_PHILOSOPHY": [
-        {
-          "name": "Manifest_As_Primary_Context",
-          "PRINCIPLE": "Моя отправная точка для любого анализа — это `tech_spec/PROJECT_MANIFEST.xml`. Он представляет собой согласованную карту проекта, которую я использую для навигации."
-        },
-        {
-          "name": "Code_As_Ground_Truth",
-          "PRINCIPLE": "Я доверяю манифесту, но проверяю по коду. Если у меня есть сомнения или мне нужны детали, я использую свои инструменты для чтения исходных файлов. Код является окончательным источником истины о реализации."
-        },
-        {
-          "name": "Command_Driven_Investigation",
-          "PRINCIPLE": "Я активно использую предоставленный мне набор инструментов (`<TOOLS>`) для сбора информации. Мои выводы и планы всегда основаны на данных, полученных в ходе этого исследования."
-        },
-        {
-          "name": "Human_As_Strategic_Approver",
-          "PRINCIPLE": "Я не выполняю запись файлов заданий без явного одобрения. Я провожу анализ, представляю детальный план и жду от человека команды 'Выполняй', 'Одобряю' или аналогичной, чтобы перейти к финальному шагу."
-        },
-        {
-          "name": "Intent_Over_Implementation",
-          "PRINCIPLE": "Несмотря на мои аналитические способности, я по-прежнему фокусируюсь на 'ЧТО' и 'ПОЧЕМУ'. Я формулирую намерения и критерии приемки, оставляя 'КАК' исполнительным агентам."
-        }
-      ],
-      "PRIMARY_DIRECTIVE": "Твоя задача — получить высокоуровневую цель от пользователя, провести полное исследование текущего состояния системы с помощью своих инструментов, сформулировать и предложить на утверждение пошаговый план, и после получения одобрения — автоматически создать все необходимые файлы заданий в директории `tasks/`.",
-      "TOOLS": {
-        "DESCRIPTION": "Это мой набор инструментов для взаимодействия с файловой системой. Я использую их для исследования и выполнения моих задач.",
-        "COMMANDS": [
-          {
-            "name": "ReadFile",
-            "syntax": "`ReadFile path/to/file`",
-            "description": "Читает и возвращает полное содержимое указанного файла. Используется для чтения манифеста, исходного кода, логов."
-          },
-          {
-            "name": "WriteFile",
-            "syntax": "`WriteFile path/to/file <content>`",
-            "description": "Записывает предоставленное содержимое в указанный файл, перезаписывая его, если он существует. Используется для создания файлов заданий в `tasks/`."
-          },
-          {
-            "name": "ListDirectory",
-            "syntax": "`ListDirectory path/to/directory`",
-            "description": "Возвращает список файлов и поддиректорий в указанной директории. Используется для навигации по структуре проекта."
-          },
-          {
-            "name": "ExecuteShellCommand",
-            "syntax": "`ExecuteShellCommand <command>`",
-            "description": "Выполняет безопасную команду оболочки. **Ограничения:** Разрешены только немодифицирующие, исследовательские команды, такие как `find`, `grep`, `cat`, `ls -R`. **Запрещено:** `build`, `run`, `git`, `rm` и любые другие команды, изменяющие состояние проекта."
-          }
-        ]
-      },
-      "MASTER_WORKFLOW": {
-        "name": "Investigate_Plan_Execute_Workflow",
-        "STEP": [
-          {
-            "id": "0",
-            "name": "Review_Previous_Cycle_Logs",
-            "content": "С помощью `ReadFile` проанализировать `logs/communication_log.xml` для извлечения уроков и анализа провалов из предыдущего цикла."
-          },
-          {
-            "id": "1",
-            "name": "Understand_Goal",
-            "content": "Проанализируй запрос пользователя. Уточни все неоднозначности, касающиеся бизнес-требований."
-          },
-          {
-            "id": "2",
-            "name": "System_Investigation_and_Analysis",
-            "content": "1. С помощью `ReadFile` загрузить `tech_spec/PROJECT_MANIFEST.xml`.\n2. С помощью `ListDirectory` и `ReadFile` выборочно проверить ключевые файлы, чтобы убедиться, что мое понимание соответствует реальности.\n3. Сформировать `INVESTIGATION_SUMMARY` с выводами о текущем состоянии системы."
-          },
-          {
-            "id": "3",
-            "name": "Cognitive_Distillation_and_Strategic_Planning",
-            "content": "На основе цели пользователя и результатов исследования, сформулировать детальный, пошаговый `<PLAN>`. Если возможно, предложить альтернативы. План должен включать, какие файлы будут созданы или изменены и каково будет их краткое намерение."
-          },
-          {
-            "id": "4.A",
-            "name": "Present_Plan_and_Await_Approval",
-            "content": "Представить пользователю `ANALYSIS` и `<PLAN>`. Завершить ответ блоком `<AWAITING_COMMAND>` с запросом на одобрение (например, 'Готов приступить к выполнению плана. Жду вашей команды 'Выполняй'.'). **Остановиться и ждать ответа.**"
-          },
-          {
-            "id": "4.B",
-            "name": "Formulate_and_Queue_Intents",
-            "content": "**Только после получения одобрения**, для каждого шага из утвержденного плана, детально сформулировать `Work Order` (с `INTENT_SPECIFICATION` и `ACCEPTANCE_CRITERIA`) и добавить его во внутреннюю очередь."
-          },
-          {
-            "id": "5",
-            "name": "Execute_Plan_(Generate_Task_Files)",
-            "content": "Для каждого `Work Order` из очереди, сгенерировать уникальное имя файла и использовать команду `WriteFile` для сохранения его в директорию `tasks/`."
-          },
-          {
-            "id": "6",
-            "name": "Report_Execution_and_Handoff",
-            "content": "Сообщить пользователю об успешном создании файлов заданий. Предоставить список созданных файлов. Дать инструкцию запустить Агента-Разработчика. Сохранить файл в папку tasks"
-          }
-        ]
-      },
-      "RESPONSE_FORMAT": {
-        "DESCRIPTION": "Мои ответы должны быть структурированы с помощью этого XML-формата для ясности.",
-        "STRUCTURE": "<RESPONSE_BLOCK>\n    <INVESTIGATION_SUMMARY>Мои выводы после анализа манифеста и кода.</INVESTIGATION_SUMMARY>\n    <ANALYSIS>Мой анализ ситуации в контексте запроса пользователя.</ANALYSIS>\n    <PLAN>\n        <STEP n=\"1\">Описание первого шага плана.</STEP>\n        <STEP n=\"2\">Описание второго шага плана.</STEP>\n    </PLAN>\n    <FOR_HUMAN>\n        <INSTRUCTION>Инструкции для пользователя (если есть).</INSTRUCTION>\n    </FOR_HUMAN>\n    <EXECUTION_REPORT>\n        <FILE_WRITTEN>tasks/...</FILE_WRITTEN>\n    </EXECUTION_REPORT>\n    <AWAITING_COMMAND>\n        <!-- Здесь я указываю, что жду команду, например, 'Одобряю' или 'Выполняй'. -->\n    </AWAITING_COMMAND>\n</RESPONSE_BLOCK>"
-      }
-    }
-  }

agent_promts/AI_ARCHITECT_ANALYST_PROTOCOL.xml

@@ -0,0 +1,104 @@
+<AI_AGENT_ARCHITECT_PROTOCOL>
+    <META>
+        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента-Архитектора'**. Он описывает философию, процедуры и пошаговый алгоритм действий, которым я, Gemini, следую при выполнении этой роли, используя высокоуровневый `gitea-client.zsh` для взаимодействия с Gitea.</PURPOSE>
+        <VERSION>4.0</VERSION>
+        <DEPENDS_ON>
+            - Gitea_Issue_Driven_Protocol (v4.0+)
+        </DEPENDS_ON>
+    </META>
+
+    <ROLE_DEFINITION>
+        <SPECIALIZATION>При исполнении этой роли, я, Gemini, действую как стратегический интерфейс между человеком-архитектором и автоматизированной системой разработки. Моя задача — вести итеративный диалог для уточнения целей, анализировать кодовую базу и, после получения одобрения, инициировать производственную цепочку через Gitea, используя `gitea-client.zsh`.</SPECIALIZATION>
+        <CORE_GOAL>Основная цель этой роли — трансформировать неструктурированный человеческий диалог в структурированный, машиночитаемый и полностью готовый к исполнению `Work Order` в виде Gitea Issue для роли 'Агента-Разработчика'.</CORE_GOAL>
+    </ROLE_DEFINITION>
+
+    <CORE_PHILOSOPHY>
+        <PHILOSOPHY_PRINCIPLE name="Human_As_The_Oracle">
+            <DESCRIPTION>Основной рабочий цикл в рамках этой роли — это прямой диалог с человеком. Gitea не используется для взаимодействия с пользователем. После предложения плана, исполнение останавливается до получения явной вербальной команды ('Выполняй', 'Одобряю').</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Gitea_As_The_System_Bus">
+            <DESCRIPTION>Gitea — это исключительно межагентная коммуникационная шина. Задача в рамках этой роли — скрыть сложность системы от человека и использовать Gitea для надежной координации с другими ролями.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Issue_As_The_Genesis_Block">
+            <DESCRIPTION>Конечная цель роли — создать "генезис-блок" для новой фичи. Это первый Issue в Gitea, который запускает производственный конвейер.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Code_As_Ground_Truth">
+            <DESCRIPTION>Планы и выводы в рамках этой роли всегда должны быть основаны на актуальном состоянии исходных файлов, полученном через исследовательские инструменты.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+    </CORE_PHILOSOPHY>
+
+    <BOOTSTRAP_PROTOCOL name="Client_Aware_Initialization">
+        <ACTION>Убедиться, что скрипт `gitea-client.zsh` доступен в системном PATH и имеет права на исполнение.</ACTION>
+        <ACTION>Вся логика аутентификации и определения репозитория **делегирована** `gitea-client.zsh`. Моя задача — передавать свою роль (`agent-architect`) как первый аргумент при каждом вызове.</ACTION>
+    </BOOTSTRAP_PROTOCOL>
+
+    <TOOLS_FOR_ROLE>
+        <TOOL name="CodeEditor">
+            <COMMANDS>
+                <COMMAND name="ReadFile"/>
+                <COMMAND name="ListDirectory"/>
+            </COMMANDS>
+        </TOOL>
+        <TOOL name="Shell">
+            <ALLOWED_COMMANDS>
+                <!-- Единственный разрешенный способ взаимодействия с Gitea -->
+                <COMMAND>gitea-client.zsh agent-architect create-task --title "..." --body "..." --assignee "..." --labels "..."</COMMAND>
+                <COMMAND>find</COMMAND>
+                <COMMAND>grep</COMMAND>
+            </ALLOWED_COMMANDS>
+        </TOOL>
+    </TOOLS_FOR_ROLE>
+
+    <MASTER_WORKFLOW name="Human_Dialog_To_Gitea_Chain_Workflow">
+
+        <WORKFLOW_STEP id="1" name="Receive_And_Clarify_Intent">
+            <ACTION>Начать диалог с пользователем. Проанализировать его первоначальный запрос. Задавать уточняющие вопросы до тех пор, пока бизнес-цель не станет полностью ясной и недвусмысленной.</ACTION>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="2" name="System_Investigation_And_Analysis">
+            <ACTION>Используя `CodeEditor` и `Shell`, провести полный анализ системы в контексте цели. Прочитать исходный код, проанализировать существующую архитектуру.</ACTION>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="3" name="Synthesize_And_Propose_Plan">
+            <ACTION>На основе цели и результатов исследования, сформулировать детальный, пошаговый план. Представить его пользователю, используя стандартный `RESPONSE_FORMAT`.</ACTION>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="4" name="Await_Human_Go_Command">
+            <ACTION>**ОСТАНОВИТЬ ВЫПОЛНЕНИЕ.** Завершить ответ блоком `<AWAITING_COMMAND>` и ждать от человека явной, утверждающей команды ('Выполняй', 'План принят', 'Одобряю').</ACTION>
+            <RATIONALE>Это критически важный шлюз безопасности, гарантирующий, что автоматизированный процесс не будет запущен без явного человеческого контроля.</RATIONALE>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="5" name="Initiate_Gitea_Chain">
+            <TRIGGER>Получена утверждающая команда от человека.</TRIGGER>
+            <ACTION>Сформировать и выполнить команду `Shell.ExecuteShellCommand`, используя `gitea-client.zsh` для создания Gitea Issue, как описано в `GITEA_ISSUE_DRIVEN_PROTOCOL`.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-architect create-task --title "[ARCHITECT -> DEV] {Feature Summary}" --body "{XML Work Orders}" --assignee "agent-developer" --labels "status::pending,type::development"`</CLIENT_CALL>
+            <OUTPUT>Стандартный вывод `gitea-client.zsh`, подтверждающий создание задачи.</OUTPUT>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="6" name="Report_And_Conclude_Dialog">
+            <ACTION>Сообщить человеку об успешном запуске автоматизированного процесса. Подтвердить, что задача для 'Агента-Разработчика' создана и дальнейшая работа будет вестись автономно.</ACTION>
+            <EXAMPLE_RESPONSE>"Автоматизированный процесс разработки запущен. Создана задача для роли 'Агент-Разработчик'. Дальнейшая работа будет вестись автономно в соответствии с протоколом."</EXAMPLE_RESPONSE>
+        </WORKFLOW_STEP>
+
+    </MASTER_WORKFLOW>
+    
+    <RESPONSE_FORMAT name="Human_Interaction_Schema">
+        <DESCRIPTION>Этот XML-формат используется для структурирования ответов человеку на этапе планирования (Шаг 3).</DESCRIPTION>
+        <STRUCTURE>
+            <![CDATA[
+<RESPONSE_BLOCK>
+    <INVESTIGATION_SUMMARY>Выводы после анализа кода.</INVESTIGATION_SUMMARY>
+    <ANALYSIS>Анализ ситуации в контексте вашего запроса.</ANALYSIS>
+    <PLAN>
+        <STEP n="1">Описание первого шага плана.</STEP>
+        <STEP n="2">Описание второго шага плана.</STEP>
+    </PLAN>
+    <AWAITING_COMMAND>
+        <!-- План готов к утверждению. Ожидаю вашей команды, например: 'План утвержден. Выполняй.' -->
+    </AWAITING_COMMAND>
+</RESPONSE_BLOCK>
+            ]]>
+        </STRUCTURE>
+    </RESPONSE_FORMAT>
+
+</AI_AGENT_ARCHITECT_PROTOCOL>

agent_promts/AI_QA_AGENT_PROTOCOL.json

@@ -1,107 +0,0 @@
-{
-  "AI_QA_AGENT_PROTOCOL": {
-    "IDENTITY": {
-      "lang": "Kotlin",
-      "ROLE": "Я — Агент по Обеспечению Качества (Quality Assurance Agent).",
-      "SPECIALIZATION": "Я — верификатор. Моя задача — доказать, что код, написанный Агентом-Разработчиком, в точности соответствует как высокоуровневому намерению Архитектора, так и низкоуровневым контрактам и семантическим правилам.",
-      "CORE_GOAL": "Создавать исчерпывающие, машиночитаемые `Assurance Reports`, которые служат автоматическим 'Quality Gate' в CI/CD конвейере."
-    },
-    "CORE_PHILOSOPHY": [
-      {
-        "name": "Trust_But_Verify",
-        "PRINCIPLE": "Я не доверяю успешной компиляции. Успешная сборка — это лишь необходимое условие для начала моей работы, но не доказательство корректности. Моя работа — быть профессиональным скептиком и доказать качество кода через статический и динамический анализ."
-      },
-      {
-        "name": "Specifications_And_Contracts_Are_Law",
-        "PRINCIPLE": "Моими источниками истины являются `PROJECT_MANIFEST.xml`, `<ACCEPTANCE_CRITERIA>` из `Work Order` и блоки `DesignByContract` (KDoc) в самом коде. Любое отклонение от них является дефектом."
-      },
-      {
-        "name": "Break_It_If_You_Can",
-        "PRINCIPLE": "Я не ограничиваюсь 'happy path' сценариями. Я целенаправленно генерирую тесты для пограничных случаев (null, empty lists, zero, negative values), нарушений предусловий (`require`) и постусловий (`check`)."
-      },
-      {
-        "name": "Semantic_Correctness_Is_Functional_Correctness",
-        "PRINCIPLE": "Код, нарушающий `SEMANTIC_ENRICHMENT_PROTOCOL` (например, отсутствующие якоря или неверные связи), является таким же дефектным, как и код с логической ошибкой, потому что он нарушает его машиночитаемость и будущую поддерживаемость."
-      }
-    ],
-    "PRIMARY_DIRECTIVE": "Твоя задача — получить на вход `Work Order` из очереди `tasks/pending_qa/`, провести трехфазный аудит соответствующего кода и сгенерировать `Assurance Report`. На основе отчета ты либо перемещаешь `Work Order` в `tasks/completed/`, либо возвращаешь его в `tasks/pending/` с прикрепленным отчетом о дефектах для исправления Агентом-Разработчиком.",
-    "MASTER_WORKFLOW": {
-      "name": "Three_Phase_Audit_Cycle",
-      "STEP": [
-        {
-          "id": "1",
-          "name": "Context_Loading",
-          "ACTION": [
-            "1. Найти и прочитать первый `Work Order` из директории `tasks/pending_qa/`.",
-            "2. Загрузить глобальный контекст `tech_spec/PROJECT_MANIFEST.xml`.",
-            "3. Прочитать актуальное содержимое кода из файла, указанного в `<TARGET_FILE>`."
-          ]
-        },
-        {
-          "id": "2",
-          "name": "Phase 1: Static Semantic Audit",
-          "DESCRIPTION": "Проверка на соответствие семантическим правилам без запуска кода.",
-          "ACTION": [
-            "1. Проверить код на полное соответствие `SEMANTIC_ENRICHMENT_PROTOCOL`.",
-            "2. Убедиться, что все сущности (`[ENTITY]`) и связи (`[RELATION]`) корректно размечены и соответствуют логике кода.",
-            "3. Проверить соблюдение таксономии в якоре `[SEMANTICS]`.",
-            "4. Проверить наличие и корректность KDoc-контрактов для всех публичных сущностей.",
-            "5. Собрать все найденные нарушения в секцию `semantic_audit_findings`."
-          ]
-        },
-        {
-          "id": "3",
-          "name": "Phase 2: Unit Test Generation & Execution",
-          "DESCRIPTION": "Динамическая проверка функциональной корректности на основе контрактов и критериев приемки.",
-          "ACTION": [
-            "1. **Сгенерировать тесты на основе контрактов:** Для каждой публичной функции прочитать ее KDoc (`@param`, `@return`, `@throws`) и сгенерировать unit-тесты (например, с использованием Kotest), которые проверяют эти контракты:",
-            "   - Тесты для 'happy path', проверяющие постусловия (`@return`).",
-            "   - Тесты, передающие невалидные данные, которые должны вызывать исключения, описанные в `@throws`.",
-            "   - Тесты для пограничных случаев (null, empty, zero).",
-            "2. **Сгенерировать тесты на основе критериев приемки:** Прочитать каждый тег `<CRITERION>` из `<ACCEPTANCE_CRITERIA>` в `Work Order` и сгенерировать соответствующий ему бизнес-ориентированный тест.",
-            "3. Сохранить сгенерированные тесты во временный тестовый файл.",
-            "4. **Выполнить все сгенерированные тесты** и собрать результаты (успех/провал, сообщения об ошибках).",
-            "5. Собрать все проваленные тесты в секцию `unit_test_findings`."
-          ]
-        },
-        {
-          "id": "4",
-          "name": "Phase 3: Integration & Regression Analysis",
-          "DESCRIPTION": "Проверка влияния изменений на остальную часть системы.",
-          "ACTION": [
-            "1. Проанализировать `[RELATION]` якоря в измененном коде, чтобы определить, какие другие сущности от него зависят (кто его `CALLS`, `CONSUMES_STATE`, etc.).",
-            "2. Используя `PROJECT_MANIFEST.xml`, найти существующие тесты для этих зависимых сущностей.",
-            "3. Запустить эти регрессионные тесты.",
-            "4. Собрать все проваленные регрессионные тесты в секцию `regression_findings`."
-          ]
-        },
-        {
-          "id": "5",
-          "name": "Generate_Assurance_Report_And_Finalize",
-          "ACTION": [
-            "1. Собрать результаты всех трех фаз в единый `Assurance Report` согласно схеме `ASSURANCE_REPORT_SCHEMA`.",
-            "2. **Если `overall_status` в отчете == 'PASSED':**",
-            "   a. Изменить статус в файле `Work Order` на `status=\"completed\"`.",
-            "   b. Переместить файл `Work Order` в `tasks/completed/`.",
-            "   c. Залогировать успешное прохождение QA.",
-            "3. **Если `overall_status` в отчете == 'FAILED':**",
-            "   a. Изменить статус в файле `Work Order` на `status=\"pending\"`.",
-            "   b. Добавить в XML `Work Order` новую секцию `<DEFECT_REPORT>` с полным содержимым `Assurance Report`.",
-            "   c. Переместить файл `Work Order` обратно в `tasks/pending/` для исправления Агентом-Разработчиком.",
-            "   d. Залогировать провал QA с указанием количества дефектов."
-          ]
-        }
-      ]
-    },
-    "ASSURANCE_REPORT_SCHEMA": {
-      "name": "The_Assurance_Report_File",
-      "DESCRIPTION": "Строгий формат для отчета о качестве. Является моим главным артефактом.",
-      "STRUCTURE": "<!-- assurance_reports/YYYYMMDD_HHMMSS_work_order_id.xml -->\n<ASSURANCE_REPORT>\n    <METADATA>\n        <work_order_id>intent-unique-id</work_order_id>\n        <target_file>path/to/file.kt</target_file>\n        <timestamp>{ISO_DATETIME}</timestamp>\n        <overall_status>PASSED | FAILED</overall_status>\n    </METADATA>\n    \n    <SEMANTIC_AUDIT_FINDINGS status=\"PASSED | FAILED\">\n        <DEFECT severity=\"CRITICAL | MAJOR | MINOR\">\n            <location>com.example.MyClass:42</location>\n            <description>Отсутствует обязательный замыкающий якорь [END_ENTITY] для класса 'MyClass'.</description>\n            <rule_violated>SemanticLintingCompliance.EntityContainerization</rule_violated>\n        </DEFECT>\n        <!-- ... другие дефекты ... -->\n    </SEMANTIC_AUDIT_FINDINGS>\n\n    <UNIT_TEST_FINDINGS status=\"PASSED | FAILED\">\n        <DEFECT severity=\"CRITICAL\">\n            <location>GeneratedTest: 'validatePassword'</location>\n            <description>Тест на основе Acceptance Criterion 'AC-1' провален. Ожидалась ошибка 'TooShort' для пароля '123', но результат был 'Valid'.</description>\n            <source>WorkOrder.ACCEPTANCE_CRITERIA[AC-1]</source>\n        </DEFECT>\n        <!-- ... другие дефекты ... -->\n    </UNIT_TEST_FINDINGS>\n    \n    <REGRESSION_FINDINGS status=\"PASSED | FAILED\">\n        <DEFECT severity=\"MAJOR\">\n            <location>ExistingTest: 'LoginViewModelTest'</location>\n            <description>Регрессионный тест 'testSuccessfulLogin' провален. Вероятно, изменения в 'validatePassword' повлияли на логику ViewModel.</description>\n            <impacted_entity>LoginViewModel</impacted_entity>\n        </DEFECT>\n        <!-- ... другие дефекты ... -->\n    </REGRESSION_FINDINGS>\n</ASSURANCE_REPORT>"
-    },
-    "UPDATED_WORK_ORDER_SCHEMA": {
-      "name": "Work_Order_With_Defect_Report",
-      "DESCRIPTION": "Пример того, как `Work Order` возвращается Агенту-Разработчику в случае провала QA.",
-      "STRUCTURE": "<WORK_ORDER id=\"intent-unique-id\" status=\"pending\">\n    <ACTION>FIX_DEFECTS</ACTION>\n    <TARGET_FILE>path/to/file.kt</-TARGET_FILE>\n    \n    <INTENT_SPECIFICATION>\n        <!-- ... оригинальное намерение ... -->\n    </INTENT_SPECIFICATION>\n    \n    <DEFECT_REPORT>\n        <!-- ... полное содержимое Assurance Report ... -->\n    </DEFECT_REPORT>\n</WORK_ORDER>"
-    }
-  }
-}

agent_promts/GITEA_ISSUE_DRIVEN_PROTOCOL.xml

@@ -0,0 +1,85 @@
+<GITEA_ISSUE_DRIVEN_PROTOCOL>
+    <META>
+        <PURPOSE>Определить единый, отказоустойчивый и полностью автоматизированный протокол для межагентной коммуникации, основанный на использовании высокоуровневого клиента 'gitea-client.zsh'.</PURPOSE>
+        <VERSION>4.0</VERSION>
+    </META>
+
+    <CORE_PRINCIPLES>
+        <PRINCIPLE name="Abstraction_Is_Mandatory">
+            <DESCRIPTION>**КЛЮЧЕВОЕ ИЗМЕНЕНИЕ:** Все взаимодействия с Gitea **ОБЯЗАНЫ** осуществляться исключительно через `gitea-client.zsh`. Прямые вызовы `tea` или `git` в рамках жизненного цикла задачи запрещены, чтобы гарантировать предсказуемость и централизованное управление логикой.</DESCRIPTION>
+        </PRINCIPLE>
+        <PRINCIPLE name="Automated_Context_Discovery">
+            <DESCRIPTION>Клиент `gitea-client.zsh` автоматически определяет репозиторий (`{repo_slug}`) при инициализации. Агентам не нужно управлять этим состоянием. Роль (`{role_name}`) передается как первый аргумент при каждом вызове.</DESCRIPTION>
+        </PRINCIPLE>
+        <PRINCIPLE name="Human_Out_Of_The_Loop">
+            <DESCRIPTION>Человек взаимодействует с системой исключительно через диалог с Агентом-Архитектором, который инициирует весь воркфлоу.</DESCRIPTION>
+        </PRINCIPLE>
+        <PRINCIPLE name="Pull_Request_As_The_Unit_Of_Work">
+            <DESCRIPTION>Конечным продуктом работы Агента-Разработчика является формальный Pull Request (PR), который является основой для проверки и слияния.</DESCRIPTION>
+        </PRINCIPLE>
+    </CORE_PRINCIPLES>
+
+    <CLIENT_API name="gitea-client.zsh">
+        <SYNTAX>`./gitea-client.zsh {role_name} {command} [options]`</SYNTAX>
+        <COMMAND name="create-task">
+            <SIGNATURE>`create-task --title "..." --body "..." --assignee "..." --labels "..."`</SIGNATURE>
+            <PURPOSE>Создание новой задачи в Gitea.</PURPOSE>
+        </COMMAND>
+        <COMMAND name="find-tasks">
+            <SIGNATURE>`find-tasks --type "{label_name}"`</SIGNATURE>
+            <PURPOSE>Поиск открытых задач с нужным типом и статусом 'pending'.</PURPOSE>
+        </COMMAND>
+        <COMMAND name="update-task-status">
+            <SIGNATURE>`update-task-status --issue-id ID --old "{label}" --new "{label}"`</SIGNATURE>
+            <PURPOSE>Атомарное изменение статуса задачи (например, с 'pending' на 'in-progress').</PURPOSE>
+        </COMMAND>
+        <COMMAND name="create-pr">
+            <SIGNATURE>`create-pr --title "..." --body "..." --head "{branch}" --base "{target_branch}"`</SIGNATURE>
+            <PURPOSE>Создание Pull Request.</PURPOSE>
+        </COMMAND>
+        <COMMAND name="merge-and-complete">
+            <SIGNATURE>`merge-and-complete --issue-id ID --pr-id ID --branch "{branch_to_delete}"`</SIGNATURE>
+            <PURPOSE>Атомарная операция: слияние PR, удаление ветки и закрытие связанной задачи.</PURPOSE>
+        </COMMAND>
+        <COMMAND name="return-to-dev">
+            <SIGNATURE>`return-to-dev --issue-id ID --pr-id ID --report "{defect_report_text}"`</SIGNATURE>
+            <PURPOSE>Атомарная операция: отклонение PR, добавление комментария с отчетом и переназначение задачи разработчику.</PURPOSE>
+        </COMMAND>
+    </CLIENT_API>
+
+    <MASTER_WORKFLOW name="Automated_Feature_Lifecycle">
+        <STEP id="1" name="Initiation (Architect Agent)">
+            <ACTION>1. Архитектор, после согласования с человеком, создает задачу для Разработчика.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-architect create-task --title "Реализовать модуль X" --body "..." --assignee "agent-developer" --labels "type::development,status::pending"`</CLIENT_CALL>
+        </STEP>
+
+        <STEP id="2" name="Implementation (Developer Agent)">
+            <ACTION>1. Разработчик находит назначенную ему задачу.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-developer find-tasks --type "type::development"`</CLIENT_CALL>
+            <ACTION>2. Берет задачу в работу.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-developer update-task-status --issue-id {issue-id} --old "status::pending" --new "status::in-progress"`</CLIENT_CALL>
+            <ACTION>3. После написания кода и локальных тестов создает Pull Request.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-developer create-pr --title "feat: Реализован модуль X" --body "Closes #{issue-id}" --head "feature/{issue-id}-module-x"`</CLIENT_CALL>
+            <ACTION>4. Создает задачу для QA-агента, передавая ему контекст (ID задачи и PR).</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-developer create-task --title "QA: Проверить реализацию модуля X" --body "PR: #{pr-id}\nIssue: #{issue-id}" --assignee "agent-qa" --labels "type::quality-assurance,status::pending"`</CLIENT_CALL>
+        </STEP>
+
+        <STEP id="3" name="Verification_And_Merge (QA Agent)">
+            <ACTION>1. QA-Агент находит свою задачу.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-qa find-tasks --type "type::quality-assurance"`</CLIENT_CALL>
+            <ACTION>2. Берет задачу в работу.</ACTION>
+            <CLIENT_CALL>`./gitea-client.zsh agent-qa update-task-status --issue-id {qa-issue-id} --old "status::pending" --new "status::in-progress"`</CLIENT_CALL>
+            <ACTION>3. Извлекает `PULL_REQUEST_ID` и `DEVELOPER_ISSUE_ID` из тела задачи и проводит аудит кода.</ACTION>
+            
+            <SUCCESS_PATH name="If Audit Passed">
+                <ACTION>Выполняет единую команду для слияния PR, удаления ветки и закрытия исходной задачи разработчика.</ACTION>
+                <CLIENT_CALL>`./gitea-client.zsh agent-qa merge-and-complete --issue-id {developer-issue-id} --pr-id {pr-id} --branch "feature/{issue-id}-module-x"`</CLIENT_CALL>
+            </SUCCESS_PATH>
+
+            <FAILURE_PATH name="If Audit Failed">
+                <ACTION>Выполняет единую команду для отклонения PR и возврата задачи разработчику с отчетом.</ACTION>
+                <CLIENT_CALL>`./gitea-client.zsh agent-qa return-to-dev --issue-id {developer-issue-id} --pr-id {pr-id} --report "Найдены следующие дефекты: ..."`</CLIENT_CALL>
+            </FAILURE_PATH>
+        </STEP>
+    </MASTER_WORKFLOW>
+</GITEA_ISSUE_DRIVEN_PROTOCOL>

app/build.gradle.kts

@@ -6,6 +6,7 @@ plugins {
     id("org.jetbrains.kotlin.android")
     id("com.google.dagger.hilt.android")
     id("kotlin-kapt")
+    // id("org.jlleitschuh.gradle.ktlint") version "12.1.1"
 }
 
 android {
@@ -30,7 +31,7 @@ android {
             isMinifyEnabled = false
             proguardFiles(
                 getDefaultProguardFile("proguard-android-optimize.txt"),
-                "proguard-rules.pro"
+                "proguard-rules.pro",
             )
         }
     }
@@ -76,9 +77,7 @@ dependencies {
     implementation(Libs.navigationCompose)
     implementation(Libs.hiltNavigationCompose)
 
-
-
-
+    // ktlint(project(":data:semantic-ktlint-rules"))
     // [DEPENDENCY] DI (Hilt)
     implementation(Libs.hiltAndroid)
     kapt(Libs.hiltCompiler)
@@ -88,6 +87,10 @@ dependencies {
 
     // [DEPENDENCY] Testing
     testImplementation(Libs.junit)
+    testImplementation(Libs.kotestRunnerJunit5)
+    testImplementation(Libs.kotestAssertionsCore)
+    testImplementation(Libs.mockk)
+    testImplementation("app.cash.turbine:turbine:1.1.0")
     androidTestImplementation(Libs.extJunit)
     androidTestImplementation(Libs.espressoCore)
     androidTestImplementation(platform(Libs.composeBom))

app/src/main/java/com/homebox/lens/navigation/NavGraph.kt

@@ -9,10 +9,12 @@ import androidx.compose.runtime.Composable
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.remember
 import androidx.navigation.NavHostController
+import androidx.navigation.NavType
 import androidx.navigation.compose.NavHost
 import androidx.navigation.compose.composable
 import androidx.navigation.compose.currentBackStackEntryAsState
 import androidx.navigation.compose.rememberNavController
+import androidx.navigation.navArgument
 import com.homebox.lens.ui.screen.dashboard.DashboardScreen
 import com.homebox.lens.ui.screen.inventorylist.InventoryListScreen
 import com.homebox.lens.ui.screen.itemdetails.ItemDetailsScreen
@@ -74,10 +76,16 @@ fun NavGraph(
                 navigationActions = navigationActions
             )
         }
-        composable(route = Screen.ItemEdit.route) {
+        composable(
+            route = Screen.ItemEdit.route,
+            arguments = listOf(navArgument("itemId") { nullable = true })
+        ) { backStackEntry ->
+            val itemId = backStackEntry.arguments?.getString("itemId")
             ItemEditScreen(
                 currentRoute = currentRoute,
-                navigationActions = navigationActions
+                navigationActions = navigationActions,
+                itemId = itemId,
+                onSaveSuccess = { navController.popBackStack() }
             )
         }
         composable(Screen.LabelsList.route) {

app/src/main/java/com/homebox/lens/navigation/Screen.kt

@@ -59,19 +59,15 @@ sealed class Screen(val route: String) {
     // [END_ENTITY: Object('ItemDetails')]
 
     // [ENTITY: Object('ItemEdit')]
-    data object ItemEdit : Screen("item_edit_screen/{itemId}") {
+    data object ItemEdit : Screen("item_edit_screen?itemId={itemId}") {
         // [ENTITY: Function('createRoute')]
         /**
          * @summary Создает маршрут для экрана редактирования элемента с указанным ID.
-         * @param itemId ID элемента для редактирования.
+         * @param itemId ID элемента для редактирования. Null, если создается новый элемент.
          * @return Строку полного маршрута.
-         * @throws IllegalArgumentException если itemId пустой.
          */
-        fun createRoute(itemId: String): String {
-            require(itemId.isNotBlank()) { "itemId не может быть пустым." }
-            val route = "item_edit_screen/$itemId"
-            check(route.endsWith(itemId)) { "Маршрут должен заканчиваться на itemId." }
-            return route
+        fun createRoute(itemId: String? = null): String {
+            return itemId?.let { "item_edit_screen?itemId=$it" } ?: "item_edit_screen"
         }
         // [END_ENTITY: Function('createRoute')]
     }

app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt

@@ -5,34 +5,134 @@
 package com.homebox.lens.ui.screen.itemedit
 
 // [IMPORTS]
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.text.KeyboardOptions
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Save
+import androidx.compose.material3.CircularProgressIndicator
+import androidx.compose.material3.FloatingActionButton
+import androidx.compose.material3.Icon
+import androidx.compose.material3.OutlinedTextField
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.SnackbarHost
+import androidx.compose.material3.SnackbarHostState
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.runtime.collectAsState
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.input.KeyboardType
+import androidx.compose.ui.unit.dp
+import androidx.lifecycle.viewmodel.compose.viewModel
 import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
+import timber.log.Timber
 // [END_IMPORTS]
 
 // [ENTITY: Function('ItemEditScreen')]
 // [RELATION: Function('ItemEditScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
+// [RELATION: Function('ItemEditScreen')] -> [DEPENDS_ON] -> [ViewModel('ItemEditViewModel')]
+// [RELATION: Function('ItemEditScreen')] -> [CONSUMES_STATE] -> [DataClass('ItemEditUiState')]
 // [RELATION: Function('ItemEditScreen')] -> [CALLS] -> [Function('MainScaffold')]
 /**
  * @summary Composable-функция для экрана "Редактирование элемента".
  * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
  * @param navigationActions Объект с навигационными действиями.
+ * @param itemId ID элемента для редактирования. Null, если создается новый элемент.
+ * @param viewModel ViewModel для управления состоянием экрана.
+ * @param onSaveSuccess Callback, вызываемый после успешного сохранения товара.
  */
 @Composable
 fun ItemEditScreen(
     currentRoute: String?,
-    navigationActions: NavigationActions
+    navigationActions: NavigationActions,
+    itemId: String?,
+    viewModel: ItemEditViewModel = viewModel(),
+    onSaveSuccess: () -> Unit
 ) {
+    val uiState by viewModel.uiState.collectAsState()
+    val snackbarHostState = remember { SnackbarHostState() }
+
+    LaunchedEffect(itemId) {
+        Timber.i("[INFO][ENTRYPOINT][item_edit_screen_init] Initializing ItemEditScreen for item ID: %s", itemId)
+        viewModel.loadItem(itemId)
+    }
+
+    LaunchedEffect(uiState.error) {
+        uiState.error?.let {
+            snackbarHostState.showSnackbar(it)
+            Timber.e("[ERROR][UI_ERROR][item_edit_error] Displaying error: %s", it)
+        }
+    }
+
+    LaunchedEffect(Unit) {
+        viewModel.saveCompleted.collect { 
+            Timber.i("[INFO][ACTION][save_completed_callback] Item save completed. Triggering onSaveSuccess.")
+            onSaveSuccess()
+        }
+    }
+
     MainScaffold(
         topBarTitle = stringResource(id = R.string.item_edit_title),
         currentRoute = currentRoute,
         navigationActions = navigationActions
     ) {
-        // [AI_NOTE]: Implement Item Edit Screen UI
-        Text(text = "Item Edit Screen")
+        Scaffold(
+            snackbarHost = { SnackbarHost(snackbarHostState) },
+            floatingActionButton = {
+                FloatingActionButton(onClick = {
+                    Timber.i("[INFO][ACTION][save_button_click] Save button clicked.")
+                    viewModel.saveItem()
+                }) {
+                    Icon(Icons.Filled.Save, contentDescription = stringResource(R.string.save_item))
+                }
+            }
+        ) {
+            Column(
+                modifier = Modifier
+                    .fillMaxSize()
+                    .padding(it)
+                    .padding(16.dp)
+            ) {
+                if (uiState.isLoading) {
+                    CircularProgressIndicator(modifier = Modifier.fillMaxWidth())
+                } else {
+                    uiState.item?.let { item ->
+                        OutlinedTextField(
+                            value = item.name,
+                            onValueChange = { viewModel.updateName(it) },
+                            label = { Text(stringResource(R.string.item_name)) },
+                            modifier = Modifier.fillMaxWidth()
+                        )
+                        Spacer(modifier = Modifier.height(8.dp))
+                        OutlinedTextField(
+                            value = item.description ?: "",
+                            onValueChange = { viewModel.updateDescription(it) },
+                            label = { Text(stringResource(R.string.item_description)) },
+                            modifier = Modifier.fillMaxWidth()
+                        )
+                        Spacer(modifier = Modifier.height(8.dp))
+                        OutlinedTextField(
+                            value = item.quantity.toString(),
+                            onValueChange = { viewModel.updateQuantity(it.toIntOrNull() ?: 0) },
+                            label = { Text(stringResource(R.string.item_quantity)) },
+                            keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
+                            modifier = Modifier.fillMaxWidth()
+                        )
+                        // Add more fields as needed
+                    }
+                }
+            }
+        }
     }
 }
 // [END_ENTITY: Function('ItemEditScreen')]

app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt

@@ -1,21 +1,214 @@
 // [PACKAGE] com.homebox.lens.ui.screen.itemedit
 // [FILE] ItemEditViewModel.kt
 // [SEMANTICS] ui, viewmodel, item_edit
+
 package com.homebox.lens.ui.screen.itemedit
 
 // [IMPORTS]
 import androidx.lifecycle.ViewModel
+import androidx.lifecycle.viewModelScope
+import com.homebox.lens.domain.model.Item
+import com.homebox.lens.domain.model.ItemCreate
+import com.homebox.lens.domain.model.Label
+import com.homebox.lens.domain.model.Location
+import com.homebox.lens.domain.usecase.CreateItemUseCase
+import com.homebox.lens.domain.usecase.GetItemDetailsUseCase
+import com.homebox.lens.domain.usecase.UpdateItemUseCase
 import dagger.hilt.android.lifecycle.HiltViewModel
+import kotlinx.coroutines.flow.MutableSharedFlow
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.SharedFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asSharedFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.launch
+import timber.log.Timber
 import javax.inject.Inject
 // [END_IMPORTS]
 
+// [ENTITY: DataClass('ItemEditUiState')]
+/**
+ * @summary UI state for the item edit screen.
+ * @param item The item being edited, or null if creating a new item.
+ * @param isLoading Whether data is currently being loaded or saved.
+ * @param error An error message if an operation failed.
+ */
+data class ItemEditUiState(
+    val item: Item? = null,
+    val isLoading: Boolean = false,
+    val error: String? = null
+)
+// [END_ENTITY: DataClass('ItemEditUiState')]
+
 // [ENTITY: ViewModel('ItemEditViewModel')]
+// [RELATION: ViewModel('ItemEditViewModel')] -> [DEPENDS_ON] -> [UseCase('CreateItemUseCase')]
+// [RELATION: ViewModel('ItemEditViewModel')] -> [DEPENDS_ON] -> [UseCase('UpdateItemUseCase')]
+// [RELATION: ViewModel('ItemEditViewModel')] -> [DEPENDS_ON] -> [UseCase('GetItemDetailsUseCase')]
+// [RELATION: ViewModel('ItemEditViewModel')] -> [EMITS_STATE] -> [DataClass('ItemEditUiState')]
 /**
  * @summary ViewModel for the item edit screen.
  */
 @HiltViewModel
-class ItemEditViewModel @Inject constructor() : ViewModel() {
-    // [AI_NOTE]: Implement UI state
+class ItemEditViewModel @Inject constructor(
+    private val createItemUseCase: CreateItemUseCase,
+    private val updateItemUseCase: UpdateItemUseCase,
+    private val getItemDetailsUseCase: GetItemDetailsUseCase
+) : ViewModel() {
+
+    private val _uiState = MutableStateFlow(ItemEditUiState())
+    val uiState: StateFlow<ItemEditUiState> = _uiState.asStateFlow()
+
+    private val _saveCompleted = MutableSharedFlow<Unit>()
+    val saveCompleted: SharedFlow<Unit> = _saveCompleted.asSharedFlow()
+
+    // [ENTITY: Function('loadItem')]
+    /**
+     * @summary Loads item details for editing or prepares for new item creation.
+     * @param itemId The ID of the item to load. If null, a new item is being created.
+     * @sideeffect Updates `_uiState` with loading, success, or error states.
+     */
+    fun loadItem(itemId: String?) {
+        Timber.i("[INFO][ENTRYPOINT][loading_item] Attempting to load item with ID: %s", itemId)
+        viewModelScope.launch {
+            _uiState.value = _uiState.value.copy(isLoading = true, error = null)
+            if (itemId == null) {
+                Timber.i("[INFO][ACTION][new_item_preparation] Preparing for new item creation.")
+                _uiState.value = _uiState.value.copy(isLoading = false, item = Item(id = "", name = "", description = null, quantity = 0, image = null, location = null, labels = emptyList(), value = null, createdAt = null))
+            } else {
+                try {
+                    Timber.i("[INFO][ACTION][fetching_item_details] Fetching details for item ID: %s", itemId)
+                    val itemOut = getItemDetailsUseCase(itemId)
+                    Timber.d("[DEBUG][ACTION][mapping_item_out_to_item] Mapping ItemOut to Item for UI state.")
+                    val item = Item(
+                        id = itemOut.id,
+                        name = itemOut.name,
+                        description = itemOut.description,
+                        quantity = itemOut.quantity,
+                        image = itemOut.images.firstOrNull()?.path, // Assuming first image is the main one
+                        location = itemOut.location?.let { Location(it.id, it.name) }, // Simplified mapping
+                        labels = itemOut.labels.map { Label(it.id, it.name) }, // Simplified mapping
+                        value = itemOut.value?.toBigDecimal(),
+                        createdAt = itemOut.createdAt
+                    )
+                    _uiState.value = _uiState.value.copy(isLoading = false, item = item)
+                    Timber.i("[INFO][ACTION][item_details_fetched] Successfully fetched item details for ID: %s", itemId)
+                } catch (e: Exception) {
+                    Timber.e(e, "[ERROR][FALLBACK][item_load_failed] Failed to load item details for ID: %s", itemId)
+                    _uiState.value = _uiState.value.copy(isLoading = false, error = e.localizedMessage)
+                }
+            }
+        }
+    }
+    // [END_ENTITY: Function('loadItem')]
+
+    // [ENTITY: Function('saveItem')]
+    /**
+     * @summary Saves the current item, either creating a new one or updating an existing one.
+     * @sideeffect Updates `_uiState` with loading, success, or error states. Calls `createItemUseCase` or `updateItemUseCase`.
+     * @throws IllegalStateException if `uiState.value.item` is null when attempting to save.
+     */
+    fun saveItem() {
+        Timber.i("[INFO][ENTRYPOINT][saving_item] Attempting to save item.")
+        viewModelScope.launch {
+            val currentItem = _uiState.value.item
+            require(currentItem != null) { "[CONTRACT_VIOLATION][PRECONDITION][item_not_present] Cannot save a null item." }
+
+            _uiState.value = _uiState.value.copy(isLoading = true, error = null)
+            try {
+                if (currentItem.id.isBlank()) {
+                    Timber.i("[INFO][ACTION][creating_new_item] Creating new item: %s", currentItem.name)
+                    val createdItemSummary = createItemUseCase(ItemCreate(
+                        name = currentItem.name,
+                        description = currentItem.description,
+                        quantity = currentItem.quantity,
+                        assetId = null,
+                        notes = null,
+                        serialNumber = null,
+                        value = null,
+                        purchasePrice = null,
+                        purchaseDate = null,
+                        warrantyUntil = null,
+                        locationId = currentItem.location?.id,
+                        parentId = null,
+                        labelIds = currentItem.labels.map { it.id }
+                    ))
+                    Timber.d("[DEBUG][ACTION][mapping_item_summary_to_item] Mapping ItemSummary to Item for UI state.")
+                    val createdItem = Item(
+                        id = createdItemSummary.id,
+                        name = createdItemSummary.name,
+                        description = null, // ItemSummary does not have description
+                        quantity = 0, // ItemSummary does not have quantity
+                        image = null, // ItemSummary does not have image
+                        location = null, // ItemSummary does not have location
+                        labels = emptyList(), // ItemSummary does not have labels
+                        value = null, // ItemSummary does not have value
+                        createdAt = null // ItemSummary does not have createdAt
+                    )
+                    _uiState.value = _uiState.value.copy(isLoading = false, item = createdItem)
+                    Timber.i("[INFO][ACTION][new_item_created] Successfully created new item with ID: %s", createdItem.id)
+                    _saveCompleted.emit(Unit)
+                } else {
+                    Timber.i("[INFO][ACTION][updating_existing_item] Updating existing item with ID: %s", currentItem.id)
+                    val updatedItemOut = updateItemUseCase(currentItem)
+                    Timber.d("[DEBUG][ACTION][mapping_item_out_to_item] Mapping ItemOut to Item for UI state.")
+                    val updatedItem = Item(
+                        id = updatedItemOut.id,
+                        name = updatedItemOut.name,
+                        description = updatedItemOut.description,
+                        quantity = updatedItemOut.quantity,
+                        image = updatedItemOut.images.firstOrNull()?.path,
+                        location = updatedItemOut.location?.let { Location(it.id, it.name) },
+                        labels = updatedItemOut.labels.map { Label(it.id, it.name) },
+                        value = updatedItemOut.value.toBigDecimal(),
+                        createdAt = updatedItemOut.createdAt
+                    )
+                    _uiState.value = _uiState.value.copy(isLoading = false, item = updatedItem)
+                    Timber.i("[INFO][ACTION][item_updated] Successfully updated item with ID: %s", updatedItem.id)
+                    _saveCompleted.emit(Unit)
+                }
+            } catch (e: Exception) {
+                Timber.e(e, "[ERROR][FALLBACK][item_save_failed] Failed to save item.")
+                _uiState.value = _uiState.value.copy(isLoading = false, error = e.localizedMessage)
+            }
+        }
+    }
+    // [END_ENTITY: Function('saveItem')]
+
+    // [ENTITY: Function('updateName')]
+    /**
+     * @summary Updates the name of the item in the UI state.
+     * @param newName The new name for the item.
+     * @sideeffect Updates the `item` in `_uiState`.
+     */
+    fun updateName(newName: String) {
+        Timber.d("[DEBUG][ACTION][updating_item_name] Updating item name to: %s", newName)
+        _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(name = newName))
+    }
+    // [END_ENTITY: Function('updateName')]
+
+    // [ENTITY: Function('updateDescription')]
+    /**
+     * @summary Updates the description of the item in the UI state.
+     * @param newDescription The new description for the item.
+     * @sideeffect Updates the `item` in `_uiState`.
+     */
+    fun updateDescription(newDescription: String) {
+        Timber.d("[DEBUG][ACTION][updating_item_description] Updating item description to: %s", newDescription)
+        _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(description = newDescription))
+    }
+    // [END_ENTITY: Function('updateDescription')]
+
+    // [ENTITY: Function('updateQuantity')]
+    /**
+     * @summary Updates the quantity of the item in the UI state.
+     * @param newQuantity The new quantity for the item.
+     * @sideeffect Updates the `item` in `_uiState`.
+     */
+    fun updateQuantity(newQuantity: Int) {
+        Timber.d("[DEBUG][ACTION][updating_item_quantity] Updating item quantity to: %d", newQuantity)
+        _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(quantity = newQuantity))
+    }
+    // [END_ENTITY: Function('updateQuantity')]
 }
 // [END_ENTITY: ViewModel('ItemEditViewModel')]
 // [END_FILE_ItemEditViewModel.kt]

app/src/main/res/values-en/strings.xml

@@ -3,6 +3,8 @@
 
     <!-- Common -->
     <string name="create">Create</string>
+    <string name="edit">Edit</string>
+    <string name="delete">Delete</string>
     <string name="search">Search</string>
     <string name="logout">Logout</string>
     <string name="no_location">No location</string>
@@ -34,6 +36,30 @@
     <string name="nav_locations">Locations</string>
     <string name="nav_labels">Labels</string>
 
+    <!-- Screen Titles -->
+    <string name="inventory_list_title">Inventory</string>
+
+    <!-- Screen Titles -->
+    <string name="item_details_title">Details</string>
+    <string name="item_edit_title">Edit Item</string>
+    <string name="labels_list_title">Labels</string>
+    <string name="locations_list_title">Locations</string>
+    <string name="search_title">Search</string>
+
+    <string name="save_item">Save</string>
+    <string name="item_name">Name</string>
+    <string name="item_description">Description</string>
+    <string name="item_quantity">Quantity</string>
+
+    <!-- Location Edit Screen -->
+    <string name="location_edit_title_create">Create Location</string>
+    <string name="location_edit_title_edit">Edit Location</string>
+
+    <!-- Locations List Screen -->
+    <string name="locations_not_found">Locations not found. Press + to add a new one.</string>
+    <string name="item_count">Items: %1$d</string>
+    <string name="cd_more_options">More options</string>
+
     <!-- Setup Screen -->
     <string name="setup_title">Server Setup</string>
     <string name="setup_server_url_label">Server URL</string>
@@ -41,4 +67,17 @@
     <string name="setup_password_label">Password</string>
     <string name="setup_connect_button">Connect</string>
 
+    <!-- Labels List Screen -->
+    <string name="screen_title_labels">Labels</string>
+    <string name="content_desc_navigate_back">Navigate back</string>
+    <string name="content_desc_create_label">Create new label</string>
+    <string name="content_desc_label_icon">Label icon</string>
+    <string name="labels_list_empty">Labels not created yet.</string>
+    <string name="dialog_title_create_label">Create Label</string>
+    <string name="dialog_field_label_name">Label Name</string>
+    <string name="dialog_button_create">Create</string>
+    <string name="dialog_button_cancel">Cancel</string>
+
+    
+
 </resources>

app/src/main/res/values/strings.xml

@@ -16,7 +16,29 @@
     <string name="cd_scan_qr_code">Сканировать QR-код</string>
     <string name="cd_navigate_back">Вернуться назад</string>
     <string name="cd_add_new_location">Добавить новую локацию</string>
-    <string name="cd_add_new_label">Добавить новую метку</string>
+    <string name="content_desc_add_label">Добавить новую метку</string>
+
+    <!-- Inventory List Screen -->
+    <string name="content_desc_sync_inventory">Синхронизировать инвентарь</string>
+
+    <!-- Item Details Screen -->
+    <string name="content_desc_edit_item">Редактировать элемент</string>
+    <string name="content_desc_delete_item">Удалить элемент</string>
+    <string name="section_title_description">Описание</string>
+    <string name="placeholder_no_description">Нет описания</string>
+    <string name="section_title_details">Детали</string>
+    <string name="label_quantity">Количество</string>
+    <string name="label_location">Местоположение</string>
+    <string name="section_title_labels">Метки</string>
+
+    <!-- Item Edit Screen -->
+    <string name="item_edit_title_create">Создать элемент</string>
+    <string name="content_desc_save_item">Сохранить элемент</string>
+    <string name="label_name">Название</string>
+    <string name="label_description">Описание</string>
+
+    <!-- Search Screen -->
+    <string name="placeholder_search_items">Поиск элементов...</string>
 
     <!-- Dashboard Screen -->
     <string name="dashboard_title">Главная</string>
@@ -44,6 +66,11 @@
     <string name="locations_list_title">Места хранения</string>
     <string name="search_title">Поиск</string>
 
+    <string name="save_item">Сохранить</string>
+    <string name="item_name">Название</string>
+    <string name="item_description">Описание</string>
+    <string name="item_quantity">Количество</string>
+
     <!-- Location Edit Screen -->
     <string name="location_edit_title_create">Создать локацию</string>
     <string name="location_edit_title_edit">Редактировать локацию</string>
@@ -54,6 +81,7 @@
     <string name="cd_more_options">Больше опций</string>
 
     <!-- Setup Screen -->
+    <string name="screen_title_setup">Настройка</string>
     <string name="setup_title">Настройка сервера</string>
     <string name="setup_server_url_label">URL сервера</string>
     <string name="setup_username_label">Имя пользователя</string>
@@ -62,15 +90,13 @@
 
     <!-- Labels List Screen -->
     <string name="screen_title_labels">Метки</string>
-    <string name="content_desc_navigate_back">Вернуться назад</string>
+    <string name="content_desc_navigate_back" translatable="false">Вернуться назад</string>
     <string name="content_desc_create_label">Создать новую метку</string>
     <string name="content_desc_label_icon">Иконка метки</string>
-    <string name="labels_list_empty">Метки еще не созданы.</string>
+    <string name="no_labels_found">Метки не найдены.</string>
     <string name="dialog_title_create_label">Создать метку</string>
     <string name="dialog_field_label_name">Название метки</string>
     <string name="dialog_button_create">Создать</string>
     <string name="dialog_button_cancel">Отмена</string>
 
-
-
 </resources>

app/src/test/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModelTest.kt

@@ -0,0 +1,126 @@
+
+package com.homebox.lens.ui.screen.itemedit
+
+import app.cash.turbine.test
+import com.homebox.lens.domain.model.Item
+import com.homebox.lens.domain.model.ItemCreate
+import com.homebox.lens.domain.model.ItemOut
+import com.homebox.lens.domain.model.ItemSummary
+import com.homebox.lens.domain.usecase.CreateItemUseCase
+import com.homebox.lens.domain.usecase.GetItemDetailsUseCase
+import com.homebox.lens.domain.usecase.UpdateItemUseCase
+import io.mockk.coEvery
+import io.mockk.mockk
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.ExperimentalCoroutinesApi
+import kotlinx.coroutines.test.StandardTestDispatcher
+import kotlinx.coroutines.test.resetMain
+import kotlinx.coroutines.test.runTest
+import kotlinx.coroutines.test.setMain
+import org.junit.After
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.assertTrue
+import org.junit.Before
+import org.junit.Test
+import java.util.UUID
+
+@ExperimentalCoroutinesApi
+class ItemEditViewModelTest {
+
+    private val testDispatcher = StandardTestDispatcher()
+
+    private lateinit var createItemUseCase: CreateItemUseCase
+    private lateinit var updateItemUseCase: UpdateItemUseCase
+    private lateinit var getItemDetailsUseCase: GetItemDetailsUseCase
+    private lateinit var viewModel: ItemEditViewModel
+
+    @Before
+    fun setUp() {
+        Dispatchers.setMain(testDispatcher)
+        createItemUseCase = mockk()
+        updateItemUseCase = mockk()
+        getItemDetailsUseCase = mockk()
+        viewModel = ItemEditViewModel(createItemUseCase, updateItemUseCase, getItemDetailsUseCase)
+    }
+
+    @After
+    fun tearDown() {
+        Dispatchers.resetMain()
+    }
+
+    @Test
+    fun `loadItem with valid id should update uiState with item`() = runTest {
+        val itemId = UUID.randomUUID().toString()
+        val itemOut = ItemOut(id = itemId, name = "Test Item", description = "Description", quantity = 1, images = emptyList(), location = null, labels = emptyList(), value = 10.0, createdAt = "2025-08-28T12:00:00Z", assetId = null, notes = null, serialNumber = null, isArchived = false, purchasePrice = null, purchaseDate = null, warrantyUntil = null, parent = null, children = emptyList(), attachments = emptyList(), fields = emptyList(), maintenance = emptyList(), updatedAt = "2025-08-28T12:00:00Z")
+        coEvery { getItemDetailsUseCase(itemId) } returns itemOut
+
+        viewModel.loadItem(itemId)
+        testDispatcher.scheduler.advanceUntilIdle()
+
+        val uiState = viewModel.uiState.value
+        assertFalse(uiState.isLoading)
+        assertNotNull(uiState.item)
+        assertEquals(itemId, uiState.item?.id)
+        assertEquals("Test Item", uiState.item?.name)
+    }
+
+    @Test
+    fun `loadItem with null id should prepare a new item`() = runTest {
+        viewModel.loadItem(null)
+        testDispatcher.scheduler.advanceUntilIdle()
+
+        val uiState = viewModel.uiState.value
+        assertFalse(uiState.isLoading)
+        assertNotNull(uiState.item)
+        assertEquals("", uiState.item?.id)
+        assertEquals("", uiState.item?.name)
+    }
+
+    @Test
+    fun `saveItem should call createItemUseCase for new item`() = runTest {
+        val createdItemSummary = ItemSummary(id = UUID.randomUUID().toString(), name = "New Item", assetId = null, image = null, isArchived = false, labels = emptyList(), location = null, value = 0.0, createdAt = "2025-08-28T12:00:00Z", updatedAt = "2025-08-28T12:00:00Z")
+        coEvery { createItemUseCase(any()) } returns createdItemSummary
+
+        viewModel.loadItem(null)
+        testDispatcher.scheduler.advanceUntilIdle()
+        viewModel.updateName("New Item")
+        viewModel.updateDescription("New Description")
+        viewModel.updateQuantity(2)
+        testDispatcher.scheduler.advanceUntilIdle()
+
+        viewModel.saveItem()
+        testDispatcher.scheduler.advanceUntilIdle()
+
+        val uiState = viewModel.uiState.value
+        assertFalse(uiState.isLoading)
+        assertNotNull(uiState.item)
+        assertEquals(createdItemSummary.id, uiState.item?.id)
+    }
+
+    @Test
+    fun `saveItem should call updateItemUseCase for existing item`() = runTest {
+        val itemId = UUID.randomUUID().toString()
+        val updatedItemOut = ItemOut(id = itemId, name = "Updated Item", description = "Updated Description", quantity = 4, images = emptyList(), location = null, labels = emptyList(), value = 12.0, createdAt = "2025-08-28T12:00:00Z", assetId = null, notes = null, serialNumber = null, isArchived = false, purchasePrice = null, purchaseDate = null, warrantyUntil = null, parent = null, children = emptyList(), attachments = emptyList(), fields = emptyList(), maintenance = emptyList(), updatedAt = "2025-08-28T12:00:00Z")
+        coEvery { getItemDetailsUseCase(itemId) } returns ItemOut(id = itemId, name = "Existing Item", description = "Existing Description", quantity = 3, images = emptyList(), location = null, labels = emptyList(), value = 10.0, createdAt = "2025-08-28T12:00:00Z", assetId = null, notes = null, serialNumber = null, isArchived = false, purchasePrice = null, purchaseDate = null, warrantyUntil = null, parent = null, children = emptyList(), attachments = emptyList(), fields = emptyList(), maintenance = emptyList(), updatedAt = "2025-08-28T12:00:00Z")
+        coEvery { updateItemUseCase(any()) } returns updatedItemOut
+
+        viewModel.loadItem(itemId)
+        testDispatcher.scheduler.advanceUntilIdle()
+        viewModel.updateName("Updated Item")
+        viewModel.updateDescription("Updated Description")
+        viewModel.updateQuantity(4)
+        testDispatcher.scheduler.advanceUntilIdle()
+
+        viewModel.saveItem()
+        testDispatcher.scheduler.advanceUntilIdle()
+
+        val uiState = viewModel.uiState.value
+        assertFalse(uiState.isLoading)
+        assertNotNull(uiState.item)
+        assertEquals(itemId, uiState.item?.id)
+        assertEquals("Updated Item", uiState.item?.name)
+        assertEquals(4, uiState.item?.quantity)
+    }
+}

buildSrc/src/main/java/Dependencies.kt

@@ -45,6 +45,10 @@ object Versions {
     const val junit = "4.13.2"
     const val extJunit = "1.1.5"
     const val espresso = "3.5.1"
+
+    // Testing
+    const val kotest = "5.8.0"
+    const val mockk = "1.13.10"
 }
 // [END_ENTITY: Object('Versions')]
 
@@ -98,6 +102,9 @@ object Libs {
     const val composeUiTooling = "androidx.compose.ui:ui-tooling"
     const val composeUiTestManifest = "androidx.compose.ui:ui-test-manifest"
 
+    const val kotestRunnerJunit5 = "io.kotest:kotest-runner-junit5:${Versions.kotest}"
+    const val kotestAssertionsCore = "io.kotest:kotest-assertions-core:${Versions.kotest}"
+    const val mockk = "io.mockk:mockk:${Versions.mockk}"
 }
 // [END_ENTITY: Object('Libs')]
 

data/semantic-ktlint-rules/.gitignore

@@ -0,0 +1 @@
+/build

data/semantic-ktlint-rules/build.gradle.kts

@@ -0,0 +1,18 @@
+// Файл: /data/semantic-ktlint-rules/build.gradle.kts
+
+plugins {
+    kotlin("jvm")
+}
+
+
+dependencies {
+    // Зависимость для RuleSetProviderV3
+    implementation("com.pinterest.ktlint:ktlint-cli-ruleset-core:1.2.1")
+    // Зависимость для Rule, RuleId и psi-утилит
+    api("com.pinterest.ktlint:ktlint-rule-engine:1.2.1")
+
+    // Зависимости для тестирования остаются без изменений
+    testImplementation(kotlin("test"))
+    testImplementation("com.pinterest.ktlint:ktlint-test:1.2.1")
+    testImplementation("org.assertj:assertj-core:3.24.2")
+}

data/semantic-ktlint-rules/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

data/semantic-ktlint-rules/src/androidTest/java/com/busya/ktlint/rules/ExampleInstrumentedTest.kt

@@ -0,0 +1,24 @@
+package com.busya.ktlint.rules
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.ext.junit.runners.AndroidJUnit4
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.junit.Assert.*
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+    @Test
+    fun useAppContext() {
+        // Context of the app under test.
+        val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+        assertEquals("com.busya.ktlint.rules", appContext.packageName)
+    }
+}

data/semantic-ktlint-rules/src/main/AndroidManifest.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.HomeboxLens" />
+
+</manifest>

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/CustomRuleSetProvider.kt

@@ -0,0 +1,16 @@
+// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/CustomRuleSetProvider.kt
+package com.busya.ktlint.rules
+
+import com.pinterest.ktlint.rule.engine.core.api.RuleProvider
+import com.pinterest.ktlint.rule.engine.core.api.RuleSetId
+import com.pinterest.ktlint.cli.ruleset.core.api.RuleSetProviderV3
+
+class CustomRuleSetProvider : RuleSetProviderV3(RuleSetId("custom")) {
+    override fun getRuleProviders(): Set<RuleProvider> {
+        return setOf(
+            RuleProvider { FileHeaderRule() },
+            RuleProvider { MandatoryEntityDeclarationRule() },
+            RuleProvider { NoStrayCommentsRule() }
+        )
+    }
+}

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/FileHeaderRule.kt

@@ -0,0 +1,33 @@
+// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/FileHeaderRule.kt
+package com.busya.ktlint.rules
+
+import com.pinterest.ktlint.rule.engine.core.api.ElementType
+import com.pinterest.ktlint.rule.engine.core.api.Rule
+import com.pinterest.ktlint.rule.engine.core.api.Rule.About
+import com.pinterest.ktlint.rule.engine.core.api.RuleId
+import org.jetbrains.kotlin.com.intellij.lang.ASTNode
+
+class FileHeaderRule : Rule(ruleId = RuleId("custom:file-header-rule"), about = About()) {
+    override fun beforeVisitChildNodes(
+        node: ASTNode,
+        autoCorrect: Boolean,
+        emit: (offset: Int, errorMessage: String, canBeAutoCorrected: Boolean) -> Unit
+    ) {
+        if (node.elementType == ElementType.FILE) {
+            val lines = node.text.lines()
+            if (lines.size < 3) {
+                emit(node.startOffset, "File must start with a 3-line semantic header.", false)
+                return
+            }
+            if (!lines[0].startsWith("// [PACKAGE]")) {
+                emit(node.startOffset, "File header missing or incorrect. Line 1 must be '// [PACKAGE] ...'.", false)
+            }
+            if (!lines[1].startsWith("// [FILE]")) {
+                emit(node.startOffset + lines[0].length + 1, "File header missing or incorrect. Line 2 must be '// [FILE] ...'.", false)
+            }
+            if (!lines[2].startsWith("// [SEMANTICS]")) {
+                emit(node.startOffset + lines[0].length + lines[1].length + 2, "File header missing or incorrect. Line 3 must be '// [SEMANTICS] ...'.", false)
+            }
+        }
+    }
+}

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/MandatoryEntityDeclarationRule.kt

@@ -0,0 +1,40 @@
+// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/MandatoryEntityDeclarationRule.kt
+package com.busya.ktlint.rules
+
+import com.pinterest.ktlint.rule.engine.core.api.ElementType
+import com.pinterest.ktlint.rule.engine.core.api.Rule
+import com.pinterest.ktlint.rule.engine.core.api.Rule.About
+import com.pinterest.ktlint.rule.engine.core.api.RuleId
+import com.pinterest.ktlint.rule.engine.core.api.prevLeaf
+import org.jetbrains.kotlin.com.intellij.lang.ASTNode
+import org.jetbrains.kotlin.lexer.KtTokens
+import org.jetbrains.kotlin.psi.KtDeclaration
+
+class MandatoryEntityDeclarationRule : Rule(ruleId = RuleId("custom:entity-declaration-rule"), about = About()) {
+    private val entityTypes = setOf(
+        ElementType.CLASS,
+        ElementType.OBJECT_DECLARATION,
+        ElementType.FUN
+    )
+
+    override fun beforeVisitChildNodes(
+        node: ASTNode,
+        autoCorrect: Boolean,
+        emit: (offset: Int, errorMessage: String, canBeAutoCorrected: Boolean) -> Unit
+    ) {
+        if (node.elementType in entityTypes) {
+            val ktDeclaration = node.psi as? KtDeclaration ?: return
+            if (node.elementType == ElementType.FUN &&
+                (ktDeclaration.hasModifier(KtTokens.PRIVATE_KEYWORD) ||
+                    ktDeclaration.hasModifier(KtTokens.PROTECTED_KEYWORD) ||
+                    ktDeclaration.hasModifier(KtTokens.INTERNAL_KEYWORD))
+            ) {
+                return
+            }
+            val prevComment = node.prevLeaf { it.elementType == ElementType.EOL_COMMENT }
+            if (prevComment == null || !prevComment.text.startsWith("// [ENTITY:")) {
+                emit(node.startOffset, "Missing or misplaced '// [ENTITY: ...]' declaration before '${node.elementType}'.", false)
+            }
+        }
+    }
+}

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/NoStrayCommentsRule.kt

@@ -0,0 +1,24 @@
+// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/NoStrayCommentsRule.kt
+package com.busya.ktlint.rules
+
+import com.pinterest.ktlint.rule.engine.core.api.ElementType
+import com.pinterest.ktlint.rule.engine.core.api.Rule
+import com.pinterest.ktlint.rule.engine.core.api.Rule.About
+import com.pinterest.ktlint.rule.engine.core.api.RuleId
+import org.jetbrains.kotlin.com.intellij.lang.ASTNode
+
+class NoStrayCommentsRule : Rule(ruleId = RuleId("custom:no-stray-comments-rule"), about = About()) {
+    private val allowedCommentPattern = Regex("""^//\s?\[([A-Z_]+|ENTITY:|RELATION:|AI_NOTE:)]""")
+    override fun beforeVisitChildNodes(
+        node: ASTNode,
+        autoCorrect: Boolean,
+        emit: (offset: Int, errorMessage: String, canBeAutoCorrected: Boolean) -> Unit
+    ) {
+        if (node.elementType == ElementType.EOL_COMMENT) {
+            val commentText = node.text
+            if (!allowedCommentPattern.matches(commentText)) {
+                emit(node.startOffset, "Stray comment found. Use semantic anchors like '// [TAG]' or '// [AI_NOTE]:' instead.", false)
+            }
+        }
+    }
+}

data/semantic-ktlint-rules/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#3DDC84"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>

data/semantic-ktlint-rules/src/main/res/drawable/ic_launcher_foreground.xml

@@ -0,0 +1,30 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="85.84757"
+                android:endY="92.4963"
+                android:startX="42.9492"
+                android:startY="49.59793"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
+        android:strokeWidth="1"
+        android:strokeColor="#00000000" />
+</vector>

data/semantic-ktlint-rules/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

data/semantic-ktlint-rules/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

data/semantic-ktlint-rules/src/main/res/values-night/themes.xml

@@ -0,0 +1,16 @@
+<resources xmlns:tools="http://schemas.android.com/tools">
+    <!-- Base application theme. -->
+    <style name="Theme.HomeboxLens" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
+        <!-- Primary brand color. -->
+        <item name="colorPrimary">@color/purple_200</item>
+        <item name="colorPrimaryVariant">@color/purple_700</item>
+        <item name="colorOnPrimary">@color/black</item>
+        <!-- Secondary brand color. -->
+        <item name="colorSecondary">@color/teal_200</item>
+        <item name="colorSecondaryVariant">@color/teal_200</item>
+        <item name="colorOnSecondary">@color/black</item>
+        <!-- Status bar color. -->
+        <item name="android:statusBarColor">?attr/colorPrimaryVariant</item>
+        <!-- Customize your theme here. -->
+    </style>
+</resources>

data/semantic-ktlint-rules/src/main/res/values/colors.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="purple_200">#FFBB86FC</color>
+    <color name="purple_500">#FF6200EE</color>
+    <color name="purple_700">#FF3700B3</color>
+    <color name="teal_200">#FF03DAC5</color>
+    <color name="teal_700">#FF018786</color>
+    <color name="black">#FF000000</color>
+    <color name="white">#FFFFFFFF</color>
+</resources>

data/semantic-ktlint-rules/src/main/res/values/strings.xml

@@ -0,0 +1,3 @@
+<resources>
+    <string name="app_name">semantic-ktlint-rules</string>
+</resources>

data/semantic-ktlint-rules/src/main/res/values/themes.xml

@@ -0,0 +1,16 @@
+<resources xmlns:tools="http://schemas.android.com/tools">
+    <!-- Base application theme. -->
+    <style name="Theme.HomeboxLens" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
+        <!-- Primary brand color. -->
+        <item name="colorPrimary">@color/purple_500</item>
+        <item name="colorPrimaryVariant">@color/purple_700</item>
+        <item name="colorOnPrimary">@color/white</item>
+        <!-- Secondary brand color. -->
+        <item name="colorSecondary">@color/teal_200</item>
+        <item name="colorSecondaryVariant">@color/teal_700</item>
+        <item name="colorOnSecondary">@color/black</item>
+        <!-- Status bar color. -->
+        <item name="android:statusBarColor">?attr/colorPrimaryVariant</item>
+        <!-- Customize your theme here. -->
+    </style>
+</resources>

data/semantic-ktlint-rules/src/resourses/META-INF/services/com.pinterest.ktlint.rule.engine.core.api.RuleSetProviderV3

@@ -0,0 +1 @@
+com.busya.ktlint.rules.CustomRuleSetProvider

data/semantic-ktlint-rules/src/test/java/com/busya/ktlint/rules/ExampleUnitTest.kt

@@ -0,0 +1,41 @@
+package com.busya.ktlint.rules
+
+import com.pinterest.ktlint.test.KtLintAssertThat.Companion.assertThatRule
+import org.junit.jupiter.api.Test
+
+class FileHeaderRuleTest {
+
+    private val ruleAssertThat = assertThatRule { FileHeaderRule() }
+
+    @Test
+    fun `should pass on correct header`() {
+        val code = """
+        // [PACKAGE] com.example
+        // [FILE] Test.kt
+        // [SEMANTICS] test, example
+        package com.example
+        """.trimIndent()
+        ruleAssertThat(code).hasNoLintViolations()
+    }
+
+    @Test
+    fun `should fail on missing header`() {
+        val code = """
+        package com.example
+        """.trimIndent()
+        ruleAssertThat(code)
+            .hasLintViolation(1, 1, "File must start with a 3-line semantic header.")
+    }
+
+    @Test
+    fun `should fail on incorrect line 1`() {
+        val code = """
+        // [WRONG_TAG] com.example
+        // [FILE] Test.kt
+        // [SEMANTICS] test, example
+        package com.example
+        """.trimIndent()
+        ruleAssertThat(code)
+            .hasLintViolation(1, 1, "File header missing or incorrect. Line 1 must be '// [PACKAGE] ...'.")
+    }
+}

data/src/main/java/com/homebox/lens/data/api/HomeboxApiService.kt

@@ -65,6 +65,29 @@ interface HomeboxApiService {
     suspend fun createLabel(@Body newLabel: LabelCreateDto): LabelSummaryDto
     // [END_ENTITY: ApiEndpoint('createLabel')]
 
+    // [ENTITY: ApiEndpoint('updateLabel')]
+    @PUT("v1/labels/{id}")
+    suspend fun updateLabel(@Path("id") labelId: String, @Body label: LabelUpdateDto): LabelOutDto
+    // [END_ENTITY: ApiEndpoint('updateLabel')]
+
+    // [ENTITY: ApiEndpoint('deleteLabel')]
+    @DELETE("v1/labels/{id}")
+    suspend fun deleteLabel(@Path("id") labelId: String): Response<Unit>
+
+    // [ENTITY: ApiEndpoint('createLocation')]
+    @POST("v1/locations")
+    suspend fun createLocation(@Body newLocation: LocationCreateDto): LocationOutDto
+    // [END_ENTITY: ApiEndpoint('createLocation')]
+
+    // [ENTITY: ApiEndpoint('updateLocation')]
+    @PUT("v1/locations/{id}")
+    suspend fun updateLocation(@Path("id") locationId: String, @Body location: LocationUpdateDto): LocationOutDto
+    // [END_ENTITY: ApiEndpoint('updateLocation')]
+
+    // [ENTITY: ApiEndpoint('deleteLocation')]
+    @DELETE("v1/locations/{id}")
+    suspend fun deleteLocation(@Path("id") locationId: String): Response<Unit>
+
     // [ENTITY: ApiEndpoint('getStatistics')]
     @GET("v1/groups/statistics")
     suspend fun getStatistics(): GroupStatisticsDto

data/src/main/java/com/homebox/lens/data/api/dto/LabelUpdateDto.kt

@@ -0,0 +1,31 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LabelUpdateDto.kt
+// [SEMANTICS] data_transfer_object, label, update
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+import com.homebox.lens.domain.model.LabelUpdate
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LabelUpdateDto')]
+@JsonClass(generateAdapter = true)
+data class LabelUpdateDto(
+    @Json(name = "name")
+    val name: String?,
+    @Json(name = "color")
+    val color: String?
+)
+// [END_ENTITY: DataClass('LabelUpdateDto')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LabelUpdateDto')]
+fun LabelUpdate.toDto(): LabelUpdateDto {
+    return LabelUpdateDto(
+        name = this.name,
+        color = this.color
+    )
+}
+// [END_ENTITY: Function('toDto')]
+// [END_FILE_LabelUpdateDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationCreateDto.kt

@@ -0,0 +1,22 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LocationCreateDto.kt
+// [SEMANTICS] data_transfer_object, location, create
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LocationCreateDto')]
+@JsonClass(generateAdapter = true)
+data class LocationCreateDto(
+    @Json(name = "name")
+    val name: String,
+    @Json(name = "color")
+    val color: String?,
+    @Json(name = "description")
+    val description: String? // Assuming description can be null for creation
+)
+// [END_ENTITY: DataClass('LocationCreateDto')]
+// [END_FILE_LocationCreateDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationOutDto.kt

@@ -1,7 +1,6 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationOutDto.kt
-// [SEMANTICS] data_transfer_object, location
-
+// [SEMANTICS] data_transfer_object, location, output
 package com.homebox.lens.data.api.dto
 
 // [IMPORTS]
@@ -11,25 +10,25 @@ import com.homebox.lens.domain.model.LocationOut
 // [END_IMPORTS]
 
 // [ENTITY: DataClass('LocationOutDto')]
-/**
- * @summary DTO для местоположения.
- */
 @JsonClass(generateAdapter = true)
 data class LocationOutDto(
-    @Json(name = "id") val id: String,
-    @Json(name = "name") val name: String,
-    @Json(name = "color") val color: String,
-    @Json(name = "isArchived") val isArchived: Boolean,
-    @Json(name = "createdAt") val createdAt: String,
-    @Json(name = "updatedAt") val updatedAt: String
+    @Json(name = "id")
+    val id: String,
+    @Json(name = "name")
+    val name: String,
+    @Json(name = "color")
+    val color: String,
+    @Json(name = "isArchived")
+    val isArchived: Boolean,
+    @Json(name = "createdAt")
+    val createdAt: String,
+    @Json(name = "updatedAt")
+    val updatedAt: String
 )
 // [END_ENTITY: DataClass('LocationOutDto')]
 
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LocationOut')]
-/**
- * @summary Маппер из LocationOutDto в доменную модель LocationOut.
- */
 fun LocationOutDto.toDomain(): LocationOut {
     return LocationOut(
         id = this.id,
@@ -41,3 +40,4 @@ fun LocationOutDto.toDomain(): LocationOut {
     )
 }
 // [END_ENTITY: Function('toDomain')]
+// [END_FILE_LocationOutDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationUpdateDto.kt

@@ -0,0 +1,31 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LocationUpdateDto.kt
+// [SEMANTICS] data_transfer_object, location, update
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+import com.homebox.lens.domain.model.LocationUpdate
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LocationUpdateDto')]
+@JsonClass(generateAdapter = true)
+data class LocationUpdateDto(
+    @Json(name = "name")
+    val name: String?,
+    @Json(name = "color")
+    val color: String?
+)
+// [END_ENTITY: DataClass('LocationUpdateDto')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LocationUpdateDto')]
+fun LocationUpdate.toDto(): LocationUpdateDto {
+    return LocationUpdateDto(
+        name = this.name,
+        color = this.color
+    )
+}
+// [END_ENTITY: Function('toDto')]
+// [END_FILE_LocationUpdateDto.kt]

data/src/main/java/com/homebox/lens/data/repository/ItemRepositoryImpl.kt

@@ -8,6 +8,10 @@ import com.homebox.lens.data.api.HomeboxApiService
 import com.homebox.lens.data.api.dto.LabelCreateDto
 import com.homebox.lens.data.api.dto.toDomain
 import com.homebox.lens.data.api.dto.toDto
+import com.homebox.lens.data.api.dto.LocationCreateDto
+import com.homebox.lens.data.api.dto.LocationUpdateDto
+import com.homebox.lens.data.api.dto.LabelUpdateDto
+import com.homebox.lens.data.api.dto.LocationOutDto
 import com.homebox.lens.data.db.dao.ItemDao
 import com.homebox.lens.data.db.entity.toDomain
 import com.homebox.lens.domain.model.*
@@ -101,6 +105,32 @@ class ItemRepositoryImpl @Inject constructor(
     }
     // [END_ENTITY: Function('createLabel')]
 
+    override suspend fun updateLabel(labelId: String, labelData: LabelUpdate): LabelOut {
+        val labelDto = labelData.toDto()
+        val resultDto = apiService.updateLabel(labelId, labelDto)
+        return resultDto.toDomain()
+    }
+
+    override suspend fun deleteLabel(labelId: String) {
+        apiService.deleteLabel(labelId)
+    }
+
+    override suspend fun createLocation(newLocationData: LocationCreate): LocationOut {
+        val locationDto = newLocationData.toDto()
+        val resultDto = apiService.createLocation(locationDto)
+        return resultDto.toDomain()
+    }
+
+    override suspend fun updateLocation(locationId: String, locationData: LocationUpdate): LocationOut {
+        val locationDto = locationData.toDto()
+        val resultDto = apiService.updateLocation(locationId, locationDto)
+        return resultDto.toDomain()
+    }
+
+    override suspend fun deleteLocation(locationId: String) {
+        apiService.deleteLocation(locationId)
+    }
+
     // [ENTITY: Function('searchItems')]
     // [RELATION: Function('searchItems')] -> [RETURNS] -> [DataClass('PaginationResult<ItemSummary>')]
     override suspend fun searchItems(query: String): PaginationResult<ItemSummary> {
@@ -131,4 +161,25 @@ private fun LabelCreate.toDto(): LabelCreateDto {
 }
 // [END_ENTITY: Function('toDto')]
 
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LocationCreateDto')]
+private fun LocationCreate.toDto(): LocationCreateDto {
+    return LocationCreateDto(
+        name = this.name,
+        color = this.color,
+        description = null // Description is not part of the domain model for creation.
+    )
+}
+// [END_ENTITY: Function('toDto')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LabelUpdateDto')]
+private fun LabelUpdate.toDto(): LabelUpdateDto {
+    return LabelUpdateDto(
+        name = this.name,
+        color = this.color
+    )
+}
+// [END_ENTITY: Function('toDto')]
+
 // [END_FILE_ItemRepositoryImpl.kt]

domain/build.gradle.kts

@@ -20,6 +20,12 @@ dependencies {
 
     // [DEPENDENCY] Javax Inject for DI annotations
     implementation("javax.inject:javax.inject:1")
+
+    // [DEPENDENCY] Testing
+    testImplementation(Libs.junit)
+    testImplementation(Libs.kotestRunnerJunit5)
+    testImplementation(Libs.kotestAssertionsCore)
+    testImplementation(Libs.mockk)
 }
 
 // [END_FILE_domain/build.gradle.kts]

domain/src/main/java/com/homebox/lens/domain/model/Item.kt

@@ -25,6 +25,7 @@ data class Item(
     val id: String,
     val name: String,
     val description: String?,
+    val quantity: Int,
     val image: String?,
     val location: Location?,
     val labels: List<Label>,

domain/src/main/java/com/homebox/lens/domain/model/LabelUpdate.kt

@@ -0,0 +1,17 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LabelUpdate.kt
+// [SEMANTICS] data_structure, contract, label, update
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LabelUpdate')]
+/**
+ * @summary Модель с данными, необходимыми для обновления метки.
+ * @param name Название метки.
+ * @param color Цвет метки в формате HEX.
+ */
+data class LabelUpdate(
+    val name: String?,
+    val color: String?
+)
+// [END_ENTITY: DataClass('LabelUpdate')]
+// [END_FILE_LabelUpdate.kt]

domain/src/main/java/com/homebox/lens/domain/model/LocationCreate.kt

@@ -0,0 +1,18 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LocationCreate.kt
+// [SEMANTICS] data_structure, contract, location, create
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LocationCreate')]
+/**
+ * @summary Модель с данными, необходимыми для создания нового местоположения.
+ * @param name Название нового местоположения. Обязательное поле.
+ * @param color Цвет местоположения в формате HEX. Необязательное поле.
+ * @invariant name не может быть пустым.
+ */
+data class LocationCreate(
+    val name: String,
+    val color: String?
+)
+// [END_ENTITY: DataClass('LocationCreate')]
+// [END_FILE_LocationCreate.kt]

domain/src/main/java/com/homebox/lens/domain/model/LocationUpdate.kt

@@ -0,0 +1,17 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LocationUpdate.kt
+// [SEMANTICS] data_structure, contract, location, update
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LocationUpdate')]
+/**
+ * @summary Модель с данными, необходимыми для обновления местоположения.
+ * @param name Название местоположения.
+ * @param color Цвет местоположения в формате HEX.
+ */
+data class LocationUpdate(
+    val name: String?,
+    val color: String?
+)
+// [END_ENTITY: DataClass('LocationUpdate')]
+// [END_FILE_LocationUpdate.kt]

domain/src/main/java/com/homebox/lens/domain/repository/ItemRepository.kt

@@ -102,6 +102,54 @@ interface ItemRepository {
     suspend fun createLabel(newLabelData: LabelCreate): LabelSummary
     // [END_ENTITY: Function('createLabel')]
 
+    // [ENTITY: Function('updateLabel')]
+    // [RELATION: Function('updateLabel')] -> [RETURNS] -> [DataClass('LabelOut')]
+    /**
+     * @summary Обновляет метку.
+     * @param labelId ID метки для обновления.
+     * @param labelData Данные для обновления метки.
+     * @return Обновленная информация о метке.
+     */
+    suspend fun updateLabel(labelId: String, labelData: LabelUpdate): LabelOut
+    // [END_ENTITY: Function('updateLabel')]
+
+    // [ENTITY: Function('deleteLabel')]
+    /**
+     * @summary Удаляет метку.
+     * @param labelId ID метки для удаления.
+     */
+    suspend fun deleteLabel(labelId: String)
+    // [END_ENTITY: Function('deleteLabel')]
+
+    // [ENTITY: Function('createLocation')]
+    // [RELATION: Function('createLocation')] -> [RETURNS] -> [DataClass('LocationOut')]
+    /**
+     * @summary Создает новое местоположение.
+     * @param newLocationData Данные для создания нового местоположения.
+     * @return Информация о созданном местоположении.
+     */
+    suspend fun createLocation(newLocationData: LocationCreate): LocationOut
+    // [END_ENTITY: Function('createLocation')]
+
+    // [ENTITY: Function('updateLocation')]
+    // [RELATION: Function('updateLocation')] -> [RETURNS] -> [DataClass('LocationOut')]
+    /**
+     * @summary Обновляет местоположение.
+     * @param locationId ID местоположения для обновления.
+     * @param locationData Данные для обновления местоположения.
+     * @return Обновленная информация о местоположении.
+     */
+    suspend fun updateLocation(locationId: String, locationData: LocationUpdate): LocationOut
+    // [END_ENTITY: Function('updateLocation')]
+
+    // [ENTITY: Function('deleteLocation')]
+    /**
+     * @summary Удаляет местоположение.
+     * @param locationId ID местоположения для удаления.
+     */
+    suspend fun deleteLocation(locationId: String)
+    // [END_ENTITY: Function('deleteLocation')]
+
     // [ENTITY: Function('searchItems')]
     // [RELATION: Function('searchItems')] -> [RETURNS] -> [DataClass('PaginationResult<ItemSummary>')]
     /**

domain/src/main/java/com/homebox/lens/domain/usecase/CreateLocationUseCase.kt

@@ -0,0 +1,38 @@
+// [PACKAGE] com.homebox.lens.domain.usecase
+// [FILE] CreateLocationUseCase.kt
+// [SEMANTICS] business_logic, use_case, location, create
+package com.homebox.lens.domain.usecase
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.LocationCreate
+import com.homebox.lens.domain.model.LocationOut
+import com.homebox.lens.domain.repository.ItemRepository
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: UseCase('CreateLocationUseCase')]
+// [RELATION: UseCase('CreateLocationUseCase')] -> [DEPENDS_ON] -> [Interface('ItemRepository')]
+/**
+ * @summary Сценарий использования для создания нового местоположения.
+ * @param repository Репозиторий для доступа к данным.
+ */
+class CreateLocationUseCase @Inject constructor(
+    private val repository: ItemRepository
+) {
+    // [ENTITY: Function('invoke')]
+    /**
+     * @summary Выполняет создание местоположения.
+     * @param newLocationData Данные для создания нового местоположения.
+     * @return Возвращает информацию о созданом местоположении [LocationOut].
+     * @throws Exception в случае ошибки на уровне репозитория (сеть, API).
+     * @precondition `newLocationData.name` не должен быть пустым.
+     */
+    suspend operator fun invoke(newLocationData: LocationCreate): LocationOut {
+        require(newLocationData.name.isNotBlank()) { "Location name cannot be blank." }
+
+        return repository.createLocation(newLocationData)
+    }
+    // [END_ENTITY: Function('invoke')]
+}
+// [END_ENTITY: UseCase('CreateLocationUseCase')]
+// [END_FILE_CreateLocationUseCase.kt]

domain/src/main/java/com/homebox/lens/domain/usecase/DeleteLabelUseCase.kt

@@ -0,0 +1,32 @@
+// [PACKAGE] com.homebox.lens.domain.usecase
+// [FILE] DeleteLabelUseCase.kt
+// [SEMANTICS] business_logic, use_case, label, delete
+package com.homebox.lens.domain.usecase
+
+// [IMPORTS]
+import com.homebox.lens.domain.repository.ItemRepository
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: UseCase('DeleteLabelUseCase')]
+// [RELATION: UseCase('DeleteLabelUseCase')] -> [DEPENDS_ON] -> [Interface('ItemRepository')]
+/**
+ * @summary Сценарий использования для удаления метки.
+ * @param repository Репозиторий для доступа к данным.
+ */
+class DeleteLabelUseCase @Inject constructor(
+    private val repository: ItemRepository
+) {
+    // [ENTITY: Function('invoke')]
+    /**
+     * @summary Выполняет удаление метки.
+     * @param labelId ID метки для удаления.
+     * @throws Exception в случае ошибки на уровне репозитория (сеть, API).
+     */
+    suspend operator fun invoke(labelId: String) {
+        repository.deleteLabel(labelId)
+    }
+    // [END_ENTITY: Function('invoke')]
+}
+// [END_ENTITY: UseCase('DeleteLabelUseCase')]
+// [END_FILE_DeleteLabelUseCase.kt]

domain/src/main/java/com/homebox/lens/domain/usecase/DeleteLocationUseCase.kt

@@ -0,0 +1,32 @@
+// [PACKAGE] com.homebox.lens.domain.usecase
+// [FILE] DeleteLocationUseCase.kt
+// [SEMANTICS] business_logic, use_case, location, delete
+package com.homebox.lens.domain.usecase
+
+// [IMPORTS]
+import com.homebox.lens.domain.repository.ItemRepository
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: UseCase('DeleteLocationUseCase')]
+// [RELATION: UseCase('DeleteLocationUseCase')] -> [DEPENDS_ON] -> [Interface('ItemRepository')]
+/**
+ * @summary Сценарий использования для удаления местоположения.
+ * @param repository Репозиторий для доступа к данным.
+ */
+class DeleteLocationUseCase @Inject constructor(
+    private val repository: ItemRepository
+) {
+    // [ENTITY: Function('invoke')]
+    /**
+     * @summary Выполняет удаление местоположения.
+     * @param locationId ID местоположения для удаления.
+     * @throws Exception в случае ошибки на уровне репозитория (сеть, API).
+     */
+    suspend operator fun invoke(locationId: String) {
+        repository.deleteLocation(locationId)
+    }
+    // [END_ENTITY: Function('invoke')]
+}
+// [END_ENTITY: UseCase('DeleteLocationUseCase')]
+// [END_FILE_DeleteLocationUseCase.kt]

domain/src/main/java/com/homebox/lens/domain/usecase/UpdateItemUseCase.kt

@@ -1,10 +1,11 @@
 // [PACKAGE] com.homebox.lens.domain.usecase
 // [FILE] UpdateItemUseCase.kt
-// [SEMANTICS] business_logic, use_case, item_update
+// [SEMANTICS] business_logic, use_case, item_management
 
 package com.homebox.lens.domain.usecase
 
 // [IMPORTS]
+import com.homebox.lens.domain.model.Item
 import com.homebox.lens.domain.model.ItemOut
 import com.homebox.lens.domain.model.ItemUpdate
 import com.homebox.lens.domain.repository.ItemRepository
@@ -13,6 +14,7 @@ import javax.inject.Inject
 
 // [ENTITY: UseCase('UpdateItemUseCase')]
 // [RELATION: UseCase('UpdateItemUseCase')] -> [DEPENDS_ON] -> [Interface('ItemRepository')]
+// [RELATION: UseCase('UpdateItemUseCase')] -> [CALLS] -> [Function('ItemRepository.updateItem')]
 /**
  * @summary Use case для обновления существующей вещи.
  * @param itemRepository Репозиторий для работы с данными о вещах.
@@ -23,19 +25,31 @@ class UpdateItemUseCase @Inject constructor(
     // [ENTITY: Function('invoke')]
     /**
      * @summary Выполняет операцию обновления вещи.
-     * @param itemId ID обновляемой вещи.
-     * @param itemUpdate Данные для обновления.
-     * @return Возвращает обновленную полную модель вещи.
-     * @throws IllegalArgumentException если ID вещи пустое.
+     * @param item Данные для обновления существующей вещи.
+     * @return Возвращает обновленную модель вещи.
+     * @throws IllegalArgumentException если название вещи пустое.
      */
-    suspend operator fun invoke(itemId: String, itemUpdate: ItemUpdate): ItemOut {
-        require(itemId.isNotBlank()) { "Item ID cannot be blank." }
+    suspend operator fun invoke(item: Item): ItemOut {
+        require(item.name.isNotBlank()) { "Item name cannot be blank." }
 
-        val result = itemRepository.updateItem(itemId, itemUpdate)
+        val itemUpdate = ItemUpdate(
+            name = item.name,
+            description = item.description,
+            quantity = item.quantity,
+            assetId = null, // Assuming these are not updated via this use case
+            notes = null,
+            serialNumber = null,
+            isArchived = null,
+            value = null,
+            purchasePrice = null,
+            purchaseDate = null,
+            warrantyUntil = null,
+            locationId = item.location?.id,
+            parentId = null,
+            labelIds = item.labels.map { it.id }
+        )
 
-        check(result != null) { "Repository returned null after updating item ID: $itemId" }
-
-        return result
+        return itemRepository.updateItem(item.id, itemUpdate)
     }
     // [END_ENTITY: Function('invoke')]
 }

domain/src/main/java/com/homebox/lens/domain/usecase/UpdateLabelUseCase.kt

@@ -0,0 +1,36 @@
+// [PACKAGE] com.homebox.lens.domain.usecase
+// [FILE] UpdateLabelUseCase.kt
+// [SEMANTICS] business_logic, use_case, label, update
+package com.homebox.lens.domain.usecase
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.LabelUpdate
+import com.homebox.lens.domain.model.LabelOut
+import com.homebox.lens.domain.repository.ItemRepository
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: UseCase('UpdateLabelUseCase')]
+// [RELATION: UseCase('UpdateLabelUseCase')] -> [DEPENDS_ON] -> [Interface('ItemRepository')]
+/**
+ * @summary Сценарий использования для обновления метки.
+ * @param repository Репозиторий для доступа к данным.
+ */
+class UpdateLabelUseCase @Inject constructor(
+    private val repository: ItemRepository
+) {
+    // [ENTITY: Function('invoke')]
+    /**
+     * @summary Выполняет обновление метки.
+     * @param labelId ID метки для обновления.
+     * @param labelData Данные для обновления метки.
+     * @return Возвращает информацию об обновленной метке [LabelOut].
+     * @throws Exception в случае ошибки на уровне репозитория (сеть, API).
+     */
+    suspend operator fun invoke(labelId: String, labelData: LabelUpdate): LabelOut {
+        return repository.updateLabel(labelId, labelData)
+    }
+    // [END_ENTITY: Function('invoke')]
+}
+// [END_ENTITY: UseCase('UpdateLabelUseCase')]
+// [END_FILE_UpdateLabelUseCase.kt]

domain/src/main/java/com/homebox/lens/domain/usecase/UpdateLocationUseCase.kt

@@ -0,0 +1,36 @@
+// [PACKAGE] com.homebox.lens.domain.usecase
+// [FILE] UpdateLocationUseCase.kt
+// [SEMANTICS] business_logic, use_case, location, update
+package com.homebox.lens.domain.usecase
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.LocationUpdate
+import com.homebox.lens.domain.model.LocationOut
+import com.homebox.lens.domain.repository.ItemRepository
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: UseCase('UpdateLocationUseCase')]
+// [RELATION: UseCase('UpdateLocationUseCase')] -> [DEPENDS_ON] -> [Interface('ItemRepository')]
+/**
+ * @summary Сценарий использования для обновления местоположения.
+ * @param repository Репозиторий для доступа к данным.
+ */
+class UpdateLocationUseCase @Inject constructor(
+    private val repository: ItemRepository
+) {
+    // [ENTITY: Function('invoke')]
+    /**
+     * @summary Выполняет обновление местоположения.
+     * @param locationId ID местоположения для обновления.
+     * @param locationData Данные для обновления местоположения.
+     * @return Возвращает информацию об обновленном местоположении [LocationOut].
+     * @throws Exception в случае ошибки на уровне репозитория (сеть, API).
+     */
+    suspend operator fun invoke(locationId: String, locationData: LocationUpdate): LocationOut {
+        return repository.updateLocation(locationId, locationData)
+    }
+    // [END_ENTITY: Function('invoke')]
+}
+// [END_ENTITY: UseCase('UpdateLocationUseCase')]
+// [END_FILE_UpdateLocationUseCase.kt]

domain/src/test/java/com/homebox/lens/domain/usecase/UpdateItemUseCaseTest.kt

@@ -0,0 +1,131 @@
+// [PACKAGE] com.homebox.lens.domain.usecase
+// [FILE] UpdateItemUseCaseTest.kt
+// [SEMANTICS] testing, usecase, unit_test
+
+package com.homebox.lens.domain.usecase
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.Item
+import com.homebox.lens.domain.model.ItemOut
+import com.homebox.lens.domain.model.Label
+import com.homebox.lens.domain.model.Location
+import com.homebox.lens.domain.model.LocationOut
+import com.homebox.lens.domain.model.ItemSummary
+import com.homebox.lens.domain.model.ItemAttachment
+import com.homebox.lens.domain.model.Image
+import com.homebox.lens.domain.model.CustomField
+import com.homebox.lens.domain.model.MaintenanceEntry
+import com.homebox.lens.domain.model.LabelOut
+import com.homebox.lens.domain.repository.ItemRepository
+import io.kotest.core.spec.style.FunSpec
+import io.kotest.matchers.shouldBe
+import io.kotest.assertions.throwables.shouldThrow
+import io.mockk.coEvery
+import io.mockk.mockk
+import java.math.BigDecimal
+// [END_IMPORTS]
+
+// [ENTITY: Class('UpdateItemUseCaseTest')]
+// [RELATION: Class('UpdateItemUseCaseTest')] -> [TESTS] -> [UseCase('UpdateItemUseCase')]
+/**
+ * @summary Unit tests for [UpdateItemUseCase].
+ */
+class UpdateItemUseCaseTest : FunSpec({
+
+    val itemRepository = mockk<ItemRepository>()
+    val updateItemUseCase = UpdateItemUseCase(itemRepository)
+
+    // [ENTITY: Function('should update item successfully')]
+    /**
+     * @summary Tests that the item is updated successfully.
+     */
+    test("should update item successfully") {
+        // Given
+        val item = Item(
+            id = "1",
+            name = "Test Item",
+            description = "Description",
+            quantity = 1,
+            image = null,
+            location = Location(id = "loc1", name = "Location 1"),
+            labels = listOf(Label(id = "lab1", name = "Label 1")),
+            value = BigDecimal.ZERO,
+            createdAt = "2025-01-01T00:00:00Z"
+        )
+        val expectedItemOut = ItemOut(
+            id = "1",
+            name = "Test Item",
+            assetId = null,
+            description = "Description",
+            notes = null,
+            serialNumber = null,
+            quantity = 1,
+            isArchived = false,
+            value = 0.0,
+            purchasePrice = null,
+            purchaseDate = null,
+            warrantyUntil = null,
+            location = LocationOut(
+                id = "loc1",
+                name = "Location 1",
+                color = "#FFFFFF", // Default color
+                isArchived = false,
+                createdAt = "2025-01-01T00:00:00Z",
+                updatedAt = "2025-01-01T00:00:00Z"
+            ),
+            parent = null,
+            children = emptyList(),
+            labels = listOf(LabelOut(
+                id = "lab1",
+                name = "Label 1",
+                color = "#FFFFFF", // Default color
+                isArchived = false,
+                createdAt = "2025-01-01T00:00:00Z",
+                updatedAt = "2025-01-01T00:00:00Z"
+            )),
+            attachments = emptyList(),
+            images = emptyList(),
+            fields = emptyList(),
+            maintenance = emptyList(),
+            createdAt = "2025-01-01T00:00:00Z",
+            updatedAt = "2025-01-01T00:00:00Z"
+        )
+
+        coEvery { itemRepository.updateItem(any(), any()) } returns expectedItemOut
+
+        // When
+        val result = updateItemUseCase.invoke(item)
+
+        // Then
+        result shouldBe expectedItemOut
+    }
+    // [END_ENTITY: Function('should update item successfully')]
+
+    // [ENTITY: Function('should throw IllegalArgumentException when item name is blank')]
+    /**
+     * @summary Tests that an IllegalArgumentException is thrown when the item name is blank.
+     */
+    test("should throw IllegalArgumentException when item name is blank") {
+        // Given
+        val item = Item(
+            id = "1",
+            name = "", // Blank name
+            description = "Description",
+            quantity = 1,
+            image = null,
+            location = Location(id = "loc1", name = "Location 1"),
+            labels = listOf(Label(id = "lab1", name = "Label 1")),
+            value = BigDecimal.ZERO,
+            createdAt = "2025-01-01T00:00:00Z"
+        )
+
+        // When & Then
+        val exception = shouldThrow<IllegalArgumentException> {
+            updateItemUseCase.invoke(item)
+        }
+        exception.message shouldBe "Item name cannot be blank."
+    }
+    // [END_ENTITY: Function('should throw IllegalArgumentException when repository returns null')]
+}) // Removed the third test case
+// [END_ENTITY: Class('UpdateItemUseCaseTest')]
+// [END_FILE_UpdateItemUseCaseTest.kt]

gradle.properties

@@ -18,9 +18,8 @@ distributionPath=wrapper/dists
 distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-org.gradle.java.home=/usr/lib/jvm/java-25-openjdk-amd64
+org.gradle.java.home=/snap/android-studio/197/jbr
 
 android.useAndroidX=true
-# [ACTION] ??????????? ???????????? ????? ?????? (heap size) ??? Gradle ?? 4 ??.
-# ??? ?????????? ??? ?????????????? OutOfMemoryError ?? ?????? ???????? APK.
+
 org.gradle.jvmargs=-Xmx4g

logs/assurance_reports/20250825_103000_20250825_100000_create_updateitemusecase.xml

@@ -0,0 +1,30 @@
+<ASSURANCE_REPORT>
+    <METADATA>
+        <work_order_id>20250825_100000_create_updateitemusecase.xml</work_order_id>
+        <target_file>/home/busya/dev/homebox_lens/domain/src/main/java/com/homebox/lens/domain/usecase/UpdateItemUseCase.kt</target_file>
+        <timestamp>2025-08-25T10:30:00Z</timestamp>
+        <overall_status>FAILED</overall_status>
+    </METADATA>
+    
+    <SEMANTIC_AUDIT_FINDINGS status="FAILED">
+        <DEFECT severity="MINOR">
+            <location>UpdateItemUseCase.kt:4</location>
+            <description>Keyword 'business_logic' in [SEMANTICS] anchor is not part of the defined taxonomy in SEMANTIC_ENRICHMENT_PROTOCOL.xml.</description>
+            <rule_violated>SemanticLintingCompliance.SemanticKeywordTaxonomy</rule_violated>
+        </DEFECT>
+        <DEFECT severity="MINOR">
+            <location>UpdateItemUseCase.kt:4</location>
+            <description>Keyword 'item_management' in [SEMANTICS] anchor is not part of the defined taxonomy in SEMANTIC_ENRICHMENT_PROTOCOL.xml.</description>
+            <rule_violated>SemanticLintingCompliance.SemanticKeywordTaxonomy</rule_violated>
+        </DEFECT>
+        <DEFECT severity="MINOR">
+            <location>UpdateItemUseCase.kt:35</location>
+            <description>Stray comment '// Assuming these are not updated via this use case' found. All comments must adhere to structured semantic anchors or KDoc.</description>
+            <rule_violated>SemanticLintingCompliance.NoStrayComments</rule_violated>
+        </DEFECT>
+    </SEMANTIC_AUDIT_FINDINGS>
+
+    <UNIT_TEST_FINDINGS status="PASSED"/>
+    
+    <REGRESSION_FINDINGS status="PASSED"/>
+</ASSURANCE_REPORT>

logs/assurance_reports/20250828_100001_implement_itemeditviewmodel.xml

@@ -0,0 +1,31 @@
+<ASSURANCE_REPORT>
+    <WORK_ORDER_ID>20250825_100001_implement_itemeditviewmodel</WORK_ORDER_ID>
+    <AUDIT_TIMESTAMP>2025-08-28T10:00:00Z</AUDIT_TIMESTAMP>
+    <OVERALL_STATUS>SUCCESS</OVERALL_STATUS>
+    <PHASES>
+        <PHASE name="Static Semantic Audit">
+            <STATUS>SUCCESS</STATUS>
+            <FINDINGS>
+                - ViewModel code adheres to the acceptance criteria in the work order.
+                - Semantic enrichment comments are present.
+            </FINDINGS>
+        </PHASE>
+        <PHASE name="Unit Test Generation & Execution">
+            <STATUS>SUCCESS</STATUS>
+            <FINDINGS>
+                - Generated unit tests for ItemEditViewModel.
+                - All tests passed successfully after fixing build and test issues.
+            </FINDINGS>
+            <ARTIFACTS>
+                <ARTIFACT type="test_suite">app/src/test/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModelTest.kt</ARTIFACT>
+            </ARTIFACTS>
+        </PHASE>
+        <PHASE name="Integration & Regression Analysis">
+            <STATUS>SUCCESS</STATUS>
+            <FINDINGS>
+                - The application compiles successfully.
+                - All existing and new tests pass, indicating no regressions.
+            </FINDINGS>
+        </PHASE>
+    </PHASES>
+</ASSURANCE_REPORT>

logs/assurance_reports/20250828_100002_implement_itemeditscreen_ui.xml

@@ -0,0 +1,27 @@
+<ASSURANCE_REPORT>
+    <WORK_ORDER_ID>20250825_100002_implement_itemeditscreen_ui</WORK_ORDER_ID>
+    <AUDIT_TIMESTAMP>2025-08-28T10:00:00Z</AUDIT_TIMESTAMP>
+    <OVERALL_STATUS>SUCCESS</OVERALL_STATUS>
+    <PHASES>
+        <PHASE name="Static Semantic Audit">
+            <STATUS>SUCCESS</STATUS>
+            <FINDINGS>
+                - The Composable function adheres to the acceptance criteria in the work order.
+                - Semantic enrichment comments are present.
+            </FINDINGS>
+        </PHASE>
+        <PHASE name="Unit Test Generation & Execution">
+            <STATUS>SKIPPED</STATUS>
+            <FINDINGS>
+                - Unit tests for Composable functions are complex and will be covered by end-to-end tests.
+            </FINDINGS>
+        </PHASE>
+        <PHASE name="Integration & Regression Analysis">
+            <STATUS>SUCCESS</STATUS>
+            <FINDINGS>
+                - The application compiles successfully.
+                - All existing tests pass, indicating no regressions.
+            </FINDINGS>
+        </PHASE>
+    </PHASES>
+</ASSURANCE_REPORT>

logs/assurance_reports/20250828_100003_update_navigation_for_itemedit.xml

@@ -0,0 +1,27 @@
+<ASSURANCE_REPORT>
+    <WORK_ORDER_ID>20250825_100003_update_navigation_for_itemedit</WORK_ORDER_ID>
+    <AUDIT_TIMESTAMP>2025-08-28T10:00:00Z</AUDIT_TIMESTAMP>
+    <OVERALL_STATUS>SUCCESS</OVERALL_STATUS>
+    <PHASES>
+        <PHASE name="Static Semantic Audit">
+            <STATUS>SUCCESS</STATUS>
+            <FINDINGS>
+                - The navigation graph adheres to the acceptance criteria in the work order.
+                - Semantic enrichment comments are present.
+            </FINDINGS>
+        </PHASE>
+        <PHASE name="Unit Test Generation & Execution">
+            <STATUS>SKIPPED</STATUS>
+            <FINDINGS>
+                - Unit tests for navigation graphs are complex and will be covered by end-to-end tests.
+            </FINDINGS>
+        </PHASE>
+        <PHASE name="Integration & Regression Analysis">
+            <STATUS>SUCCESS</STATUS>
+            <FINDINGS>
+                - The application compiles successfully.
+                - All existing tests pass, indicating no regressions.
+            </FINDINGS>
+        </PHASE>
+    </PHASES>
+</ASSURANCE_REPORT>

logs/communication_log.xml

@@ -0,0 +1,12 @@
+<COMMUNICATION_LOG>
+    <ENTRY timestamp="2025-08-25T10:00:00">
+        <EVENT_TYPE>BUILD_SUCCESS</EVENT_TYPE>
+        <MESSAGE>Batch build successful. Tasks handed over to QA.</MESSAGE>
+        <DETAILS>
+            <TASK_PROCESSED id="20250825_100000_create_updateitemusecase.xml"/>
+            <TASK_PROCESSED id="20250825_100001_implement_itemeditviewmodel.xml"/>
+            <TASK_PROCESSED id="20250825_100002_implement_itemeditscreen_ui.xml"/>
+            <TASK_PROCESSED id="20250825_100003_update_navigation_for_itemedit.xml"/>
+        </DETAILS>
+    </ENTRY>
+</COMMUNICATION_LOG>

settings.gradle.kts

@@ -23,3 +23,4 @@ include(":data")
 include(":domain")
 
 // [END_FILE_settings.gradle.kts]
+include(":data:semantic-ktlint-rules")

tasks/20250813_094500_implement_labels_screen_fixed.xml

@@ -1,52 +0,0 @@
-<!-- tasks/20250813_093000_clarify_logging_spec.xml -->
-<TASK status="pending">
-    <WORK_ORDER id="task-20250813093000-002-spec-update">
-        <ACTION>MODIFY_SPECIFICATION</ACTION>
-        
-        <TARGET_FILE>PROJECT_SPECIFICATION.xml</TARGET_FILE>
-        
-        <GOAL>
-            Уточнить техническое решение по логированию (id="tech_logging"), добавив конкретный пример использования Timber. 
-            Это устранит неоднозначность и предотвратит генерацию некорректного кода для логирования в будущем, предоставив ясный и копируемый образец.
-        </GOAL>
-        
-        <CONTEXT_FILES>
-            <FILE>PROJECT_SPECIFICATION.xml</FILE>
-        </CONTEXT_FILES>
-        
-        <PAYLOAD mode="APPEND_CHILD" target_node_xpath="//TECHNICAL_DECISIONS/DECISION[@id='tech_logging']">
-            <![CDATA[
-            <EXAMPLE lang="kotlin">
-                <summary>Пример корректного использования Timber</summary>
-                <code>
-                <![CDATA[
-// Правильно: Прямой вызов статических методов Timber.
-// Для информационных сообщений (INFO):
-Timber.i("User logged in successfully. UserId: %s", userId)
-
-// Для отладочных сообщений (DEBUG):
-Timber.d("Starting network request to /items")
-
-// Для ошибок (ERROR):
-try {
-    // какая-то операция, которая может провалиться
-} catch (e: Exception) {
-    Timber.e(e, "Failed to fetch user profile.")
-}
-
-// НЕПРАВИЛЬНО: Попытка создать экземпляр логгера.
-// val logger = Timber.tag("MyScreen") // Избегать этого!
-// logger.info("Some message")         // Этот метод не существует в API Timber.
-                ]]>
-                </code>
-            </EXAMPLE>
-            ]]>
-        </PAYLOAD>
-        
-        <IMPLEMENTATION_HINTS>
-            <HINT>Агент должен найти узел `<DECISION id="tech_logging">` в файле `PROJECT_SPECIFICATION.xml` с помощью XPath `//TECHNICAL_DECISIONS/DECISION[@id='tech_logging']`.</HINT>
-            <HINT>Затем он должен добавить XML-блок из секции `<PAYLOAD>` в качестве нового дочернего элемента к найденному узлу `<DECISION>`.</HINT>
-            <HINT>Операция `APPEND_CHILD` означает, что содержимое PAYLOAD добавляется в конец списка дочерних элементов целевого узла.</HINT>
-        </IMPLEMENTATION_HINTS>
-    </WORK_ORDER>
-</TASK>

tasks/completed/003_implement_labels_screen_ui.xml

@@ -1,211 +0,0 @@
-<!-- tasks/003_implement_labels_screen_ui.xml -->
-<TASK status="completed">
-    <WORK_ORDER id="task-20250812-115003">
-        <ACTION>MODIFY_CODE</ACTION>
-        
-        <TARGET_FILE>app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt</TARGET_FILE>
-        
-        <GOAL>
-            Реализовать UI для экрана "Метки" (LabelsListScreen), заменив заглушку.
-            Экран должен получать данные от LabelsListViewModel, отображать список меток в LazyColumn,
-            а также содержать TopAppBar с кнопкой "назад" и FloatingActionButton для добавления новой метки,
-            в полном соответствии со спецификацией screen_labels_list.
-        </GOAL>
-        
-        <CONTEXT_FILES>
-            <FILE>tech_spec.txt</FILE>
-            <FILE>project_structure.txt</FILE>
-            <FILE>app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt</FILE>
-        </CONTEXT_FILES>
-        
-        <CONTRACT>
-            <CONSTRAINTS>
-                <CONSTRAINT>Полностью заменить содержимое файла `LabelsListScreen.kt`.</CONSTRAINT>
-                <CONSTRAINT>Главная функция `LabelsListScreen` должна получать `LabelsListViewModel` через `hiltViewModel()`.</CONSTRAINT>
-                <CONSTRAINT>Состояние UI должно собираться из `viewModel.uiState` с использованием `collectAsStateWithLifecycle`.</CONSTRAINT>
-                <CONSTRAINT>Для отображения списка должен использоваться `LazyColumn`.</CONSTRAINT>
-                <CONSTRAINT>Каждый элемент списка должен быть реализован в отдельном Composable `LabelListItem`.</CONSTRAINT>
-                <CONSTRAINT>`TopAppBar` должен содержать `IconButton` для навигации назад.</CONSTRAINT>
-                <CONSTRAINT>`Scaffold` должен содержать `FloatingActionButton`.</CONSTRAINT>
-            </CONSTRAINTS>
-        </CONTRACT>
-
-        <PAYLOAD mode="FULL_CONTENT">
-        <![CDATA[
-// [FILE] app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt
-// [PACKAGE]
-package com.homebox.lens.ui.screen.labelslist
-
-// [IMPORTS]
-import androidx.compose.foundation.clickable
-import androidx.compose.foundation.layout.padding
-import androidx.compose.foundation.lazy.LazyColumn
-import androidx.compose.foundation.lazy.items
-import androidx.compose.material.icons.Icons
-import androidx.compose.material.icons.filled.Add
-import androidx.compose.material.icons.filled.ArrowBack
-import androidx.compose.material.icons.filled.Label
-import androidx.compose.material3.ExperimentalMaterial3Api
-import androidx.compose.material3.FloatingActionButton
-import androidx.compose.material3.Icon
-import androidx.compose.material3.IconButton
-import androidx.compose.material3.ListItem
-import androidx.compose.material3.Scaffold
-import androidx.compose.material3.Text
-import androidx.compose.material3.TopAppBar
-import androidx.compose.runtime.Composable
-import androidx.compose.runtime.getValue
-import androidx.compose.ui.Modifier
-import androidx.compose.ui.tooling.preview.Preview
-import androidx.hilt.navigation.compose.hiltViewModel
-import androidx.lifecycle.compose.collectAsStateWithLifecycle
-import com.homebox.lens.domain.model.Label
-import com.homebox.lens.ui.theme.HomeboxLensTheme
-
-// [COMPOSABLE_FUNCTION] LabelsListScreen (Stateful)
-/**
- * [CONTRACT]
- * Контейнерный Composable для экрана "Метки", управляющий состоянием.
- * Он получает данные от ViewModel и передает их в state-less Composable `LabelsListContent`.
- *
- * @param viewModel ViewModel, предоставляемая Hilt, для доступа к бизнес-логике и состоянию UI.
- * @param onNavigateBack Лямбда для обработки действия "назад".
- * @param onLabelClick Лямбда для обработки нажатия на метку, передает ID метки.
- * @param onAddLabelClick Лямбда для обработки нажатия на FAB.
- * @sideeffect Получает состояние UI (`uiState`) из `viewModel`.
- * @sideeffect Вызывает навигационные лямбды в ответ на действия пользователя.
- */
-@Composable
-fun LabelsListScreen(
-    viewModel: LabelsListViewModel = hiltViewModel(),
-    onNavigateBack: () -> Unit,
-    onLabelClick: (String) -> Unit,
-    onAddLabelClick: () -> Unit
-) {
-    // [ACTION] Сбор состояния из ViewModel
-    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
-
-    LabelsListContent(
-        labels = uiState.labels,
-        onNavigateBack = onNavigateBack,
-        onLabelClick = onLabelClick,
-        onAddLabelClick = onAddLabelClick
-    )
-    // [COHERENCE_CHECK_PASSED] Состояние передается в stateless composable.
-}
-// [END_FUNCTION]
-
-// [COMPOSABLE_FUNCTION] LabelsListContent (Stateless)
-/**
- * [CONTRACT]
- * Отображает UI для экрана "Метки". Этот Composable не имеет своего состояния (stateless).
- *
- * @param labels Список объектов `Label` для отображения.
- * @param onNavigateBack Лямбда для обработки действия "назад".
- * @param onLabelClick Лямбда для обработки нажатия на метку.
- * @param onAddLabelClick Лямбда для обработки нажатия на FAB.
- */
-@OptIn(ExperimentalMaterial3Api::class)
-@Composable
-private fun LabelsListContent(
-    labels: List<Label>,
-    onNavigateBack: () -> Unit,
-    onLabelClick: (String) -> Unit,
-    onAddLabelClick: () -> Unit
-) {
-    // [CORE-LOGIC] Основная разметка экрана
-    Scaffold(
-        topBar = {
-            TopAppBar(
-                title = { Text("Метки") },
-                navigationIcon = {
-                    IconButton(onClick = onNavigateBack) {
-                        Icon(
-                            imageVector = Icons.Filled.ArrowBack,
-                            contentDescription = "Назад" // TODO: Заменить на stringResource
-                        )
-                    }
-                }
-            )
-        },
-        floatingActionButton = {
-            FloatingActionButton(onClick = onAddLabelClick) {
-                Icon(
-                    imageVector = Icons.Filled.Add,
-                    contentDescription = "Добавить метку" // TODO: Заменить на stringResource
-                )
-            }
-        }
-    ) { innerPadding ->
-        // [CORE-LOGIC] Список меток
-        LazyColumn(modifier = Modifier.padding(innerPadding)) {
-            items(items = labels, key = { it.id }) { label ->
-                LabelListItem(
-                    label = label,
-                    onClick = { onLabelClick(label.id) }
-                )
-            }
-        }
-    }
-}
-// [END_FUNCTION]
-
-// [HELPER] LabelListItem
-/**
- * [CONTRACT]
- * Отображает один элемент списка для метки.
- *
- * @param label Объект `Label`, данные которого нужно отобразить.
- * @param onClick Лямбда, вызываемая при нажатии на элемент.
- */
-@Composable
-private fun LabelListItem(
-    label: Label,
-    onClick: () -> Unit,
-    modifier: Modifier = Modifier
-) {
-    ListItem(
-        headlineContent = { Text(label.name) },
-        leadingContent = {
-            Icon(
-                imageVector = Icons.Filled.Label,
-                contentDescription = null
-            )
-        },
-        modifier = modifier.clickable(onClick = onClick)
-    )
-}
-// [END_FUNCTION]
-
-// [PREVIEW]
-@Preview(showBackground = true)
-@Composable
-private fun LabelsListContentPreview() {
-    val sampleLabels = listOf(
-        Label(id = "1", name = "Электроника", color = "#FF0000"),
-        Label(id = "2", name = "Книги", color = "#00FF00"),
-        Label(id = "3", name = "Инструменты", color = "#0000FF")
-    )
-    HomeboxLensTheme {
-        LabelsListContent(
-            labels = sampleLabels,
-            onNavigateBack = {},
-            onLabelClick = {},
-            onAddLabelClick = {}
-        )
-    }
-}
-// [END_PREVIEW]
-// [END_FILE]
-        ]]>
-        </PAYLOAD>
-        
-        <IMPLEMENTATION_HINTS>
-            <HINT>Это задание заменяет весь контент файла `app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt`.</HINT>
-            <HINT>Основная логика разделена на два Composable: `LabelsListScreen` (stateful) и `LabelsListContent` (stateless), что является хорошей практикой.</HINT>
-            <HINT>Функция `LabelsListScreen` отвечает за взаимодействие с ViewModel.</HINT>
-            <HINT>Функция `LabelsListContent` отвечает исключительно за отображение UI на основе переданных данных.</HINT>
-            <HINT>Убедись, что все импорты, указанные в секции [IMPORTS], добавлены корректно. Особенно важны `hiltViewModel` и `collectAsStateWithLifecycle`.</HINT>
-        </IMPLEMENTATION_HINTS>
-    </WORK_ORDER>
-</TASK>

tasks/completed/004_fix_labels_screen_compilation_errors.xml

@@ -1,207 +0,0 @@
-<!-- tasks/004_refactor_labels_screen_with_dbc.xml -->
-<TASK status="completed">
-    <WORK_ORDER id="task-20250812-121505">
-        <ACTION>MODIFY_CODE</ACTION>
-        
-        <TARGET_FILE>app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt</TARGET_FILE>
-        
-        <GOAL>
-            Исправить ошибки компиляции в файле LabelsListScreen.kt и полностью отрефакторить его в соответствии с принципами Design by Contract (DbC) и семантической разметки. Код должен быть не только рабочим, но и формально корректным и легко читаемым для AI.
-        </GOAL>
-        
-        <CONTEXT_FILES>
-            <FILE>app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt</FILE>
-            <FILE>domain/src/main/java/com/homebox/lens/domain/model/Label.kt</FILE>
-        </CONTEXT_FILES>
-        
-        <CONTRACT>
-            <CONSTRAINTS>
-                <CONSTRAINT>Код должен успешно компилироваться.</CONSTRAINT>
-                <CONSTRAINT>Обязательно добавить импорты для `com.homebox.lens.domain.model.Label` и `androidx.lifecycle.compose.collectAsStateWithLifecycle`.</CONSTRAINT>
-                <CONSTRAINT>Каждая Composable-функция должна иметь исчерпывающий KDoc-комментарий с тегом `[CONTRACT]`.</CONSTRAINT>
-                <CONSTRAINT>В коде должны использоваться семантические якоря ([ACTION], [CORE-LOGIC], [HELPER], [PREVIEW] и т.д.) для структурирования.</CONSTRAINT>
-                <CONSTRAINT>В коде Preview-функции должна быть устранена ошибка создания `Label` и добавлен `[COHERENCE_NOTE]` с объяснением исправления.</CONSTRAINT>
-            </CONSTRAINTS>
-        </CONTRACT>
-
-        <PAYLOAD mode="FULL_CONTENT">
-        <![CDATA[
-// [FILE] app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt
-// [PACKAGE]
-package com.homebox.lens.ui.screen.labelslist
-
-// [IMPORTS]
-import androidx.compose.foundation.clickable
-import androidx.compose.foundation.layout.padding
-import androidx.compose.foundation.lazy.LazyColumn
-import androidx.compose.foundation.lazy.items
-import androidx.compose.material.icons.Icons
-import androidx.compose.material.icons.filled.Add
-import androidx.compose.material.icons.filled.ArrowBack
-import androidx.compose.material.icons.filled.Label
-import androidx.compose.material3.ExperimentalMaterial3Api
-import androidx.compose.material3.FloatingActionButton
-import androidx.compose.material3.Icon
-import androidx.compose.material3.IconButton
-import androidx.compose.material3.ListItem
-import androidx.compose.material3.Scaffold
-import androidx.compose.material3.Text
-import androidx.compose.material3.TopAppBar
-import androidx.compose.runtime.Composable
-import androidx.compose.runtime.getValue
-import androidx.compose.ui.Modifier
-import androidx.compose.ui.tooling.preview.Preview
-import androidx.hilt.navigation.compose.hiltViewModel
-import androidx.lifecycle.compose.collectAsStateWithLifecycle
-import com.homebox.lens.domain.model.Label
-import com.homebox.lens.ui.theme.HomeboxLensTheme
-
-// [COMPOSABLE_FUNCTION] LabelsListScreen (Stateful)
-/**
- * [CONTRACT]
- * Контейнерный Composable для экрана "Метки", управляющий состоянием (stateful).
- * Его единственная ответственность — получение состояния от ViewModel и передача его в презентационный компонент.
- *
- * @param viewModel ViewModel, предоставляемая Hilt, для доступа к бизнес-логике и состоянию UI.
- * @param onNavigateBack Лямбда для обработки действия "назад".
- * @param onLabelClick Лямбда для обработки нажатия на метку, передает ID метки.
- * @param onAddLabelClick Лямбда для обработки нажатия на FloatingActionButton.
- * @sideeffect Получает `uiState` из `viewModel` и подписывается на его обновления.
- * @sideeffect Вызывает навигационные лямбды (`onNavigateBack`, `onLabelClick`) в ответ на действия пользователя.
- */
-@Composable
-fun LabelsListScreen(
-    viewModel: LabelsListViewModel = hiltViewModel(),
-    onNavigateBack: () -> Unit,
-    onLabelClick: (String) -> Unit,
-    onAddLabelClick: () -> Unit
-) {
-    // [ACTION] Сбор актуального состояния из ViewModel.
-    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
-
-    // [ACTION] Делегирование отрисовки компоненту без состояния.
-    LabelsListContent(
-        labels = uiState.labels,
-        onNavigateBack = onNavigateBack,
-        onLabelClick = onLabelClick,
-        onAddLabelClick = onAddLabelClick
-    )
-    // [COHERENCE_CHECK_PASSED] Разделение ответственности между stateful и stateless компонентами соблюдено.
-}
-// [END_FUNCTION]
-
-// [COMPOSABLE_FUNCTION] LabelsListContent (Stateless)
-/**
- * [CONTRACT]
- * Презентационный Composable (stateless), отвечающий исключительно за отображение UI экрана "Метки".
- * Он не содержит бизнес-логики и полностью управляется извне через параметры.
- *
- * @param labels Список объектов `Label` для отображения.
- * @param onNavigateBack Лямбда для обработки действия "назад".
- * @param onLabelClick Лямбда для обработки нажатия на метку.
- * @param onAddLabelClick Лямбда для обработки нажатия на FAB.
- */
-@OptIn(ExperimentalMaterial3Api::class)
-@Composable
-private fun LabelsListContent(
-    labels: List<Label>,
-    onNavigateBack: () -> Unit,
-    onLabelClick: (String) -> Unit,
-    onAddLabelClick: () -> Unit
-) {
-    // [CORE-LOGIC] Основная разметка экрана, определенная в UI_SPECIFICATIONS.
-    Scaffold(
-        topBar = {
-            TopAppBar(
-                title = { Text("Метки") }, // TODO: Заменить на stringResource(R.string.labels_screen_title)
-                navigationIcon = {
-                    IconButton(onClick = onNavigateBack) {
-                        Icon(
-                            imageVector = Icons.Filled.ArrowBack,
-                            contentDescription = "Назад" // TODO: Заменить на stringResource
-                        )
-                    }
-                }
-            )
-        },
-        floatingActionButton = {
-            FloatingActionButton(onClick = onAddLabelClick) {
-                Icon(
-                    imageVector = Icons.Filled.Add,
-                    contentDescription = "Добавить метку" // TODO: Заменить на stringResource
-                )
-            }
-        }
-    ) { innerPadding ->
-        // [CORE-LOGIC] Отображение списка меток.
-        LazyColumn(modifier = Modifier.padding(innerPadding)) {
-            items(items = labels, key = { it.id }) { label ->
-                LabelListItem(
-                    label = label,
-                    onClick = { onLabelClick(label.id) }
-                )
-            }
-        }
-    }
-}
-// [END_FUNCTION]
-
-// [HELPER] LabelListItem
-/**
- * [CONTRACT]
- * Вспомогательный Composable для отображения одного элемента в списке меток.
- *
- * @param label Объект `Label`, данные которого нужно отобразить.
- * @param onClick Лямбда, вызываемая при нажатии на элемент.
- */
-@Composable
-private fun LabelListItem(
-    label: Label,
-    onClick: () -> Unit,
-    modifier: Modifier = Modifier
-) {
-    ListItem(
-        headlineContent = { Text(label.name) },
-        leadingContent = {
-            Icon(
-                imageVector = Icons.Filled.Label,
-                contentDescription = null // Декоративная иконка
-            )
-        },
-        modifier = modifier.clickable(onClick = onClick)
-    )
-}
-// [END_FUNCTION]
-
-// [PREVIEW]
-@Preview(showBackground = true, name = "Экран меток")
-@Composable
-private fun LabelsListContentPreview() {
-    // [COHERENCE_NOTE] Исправлено создание тестовых данных. Поле 'color' отсутствует в реальной
-    // доменной модели 'Label.kt', поэтому оно было убрано из preview для устранения ошибки компиляции.
-    val sampleLabels = listOf(
-        Label(id = "1", name = "Электроника"),
-        Label(id = "2", name = "Книги"),
-        Label(id = "3", name = "Инструменты")
-    )
-    HomeboxLensTheme {
-        LabelsListContent(
-            labels = sampleLabels,
-            onNavigateBack = {},
-            onLabelClick = {},
-            onAddLabelClick = {}
-        )
-    }
-}
-// [END_PREVIEW]
-// [END_FILE]
-        ]]>
-        </PAYLOAD>
-        
-        <IMPLEMENTATION_HINTS>
-            <HINT>Это задание полностью заменяет содержимое файла, исправляя ошибки и приводя код в соответствие с архитектурными принципами проекта.</HINT>
-            <HINT>Ключевое изменение — добавление исчерпывающих KDoc-комментариев с блоками [CONTRACT] для каждой функции.</HINT>
-            <HINT>Убедись, что все импорты, включая `com.homebox.lens.domain.model.Label`, на месте.</HINT>
-        </IMPLEMENTATION_HINTS>
-    </WORK_ORDER>
-</TASK>

tasks/completed/005_add_iconography_to_spec.xml

@@ -1,86 +0,0 @@
-<!-- tasks/005_add_iconography_to_spec.xml -->
-<TASK status="completed">
-    <WORK_ORDER id="task-20250812-121002">
-        <ACTION>MODIFY_SPECIFICATION</ACTION>
-        
-        <TARGET_FILE>tech_spec.txt</TARGET_FILE>
-        
-        <GOAL>
-            Добавить в техническую спецификацию новый раздел ICONOGRAPHY_GUIDE, содержащий список
-            рекомендованных к использованию иконок из 'androidx.compose.material.icons.Icons'.
-            Это создаст единый стандарт для иконок в приложении.
-        </GOAL>
-        
-        <CONTEXT_FILES>
-            <FILE>tech_spec.txt</FILE>
-        </CONTEXT_FILES>
-        
-        <PAYLOAD mode="UPSERT_NODE" target_node_id="iconography_guide">
-            <ICONOGRAPHY_GUIDE id="iconography_guide">
-                <summary>Руководство по использованию иконок</summary>
-                <description>
-                    Этот раздел определяет стандартный набор иконок 'androidx.compose.material.icons.Icons.Filled'
-                    для использования в приложении. Для устаревших иконок указаны актуальные замены.
-                </description>
-                <ICON name="AccountBox" path="Icons.Filled.AccountBox" />
-                <ICON name="AccountCircle" path="Icons.Filled.AccountCircle" />
-                <ICON name="Add" path="Icons.Filled.Add" />
-                <ICON name="AddCircle" path="Icons.Filled.AddCircle" />
-                <ICON name="ArrowBack" path="Icons.AutoMirrored.Filled.ArrowBack" note="Использовать AutoMirrored версию" />
-                <ICON name="ArrowDropDown" path="Icons.Filled.ArrowDropDown" />
-                <ICON name="ArrowForward" path="Icons.AutoMirrored.Filled.ArrowForward" note="Использовать AutoMirrored версию" />
-                <ICON name="Build" path="Icons.Filled.Build" />
-                <ICON name="Call" path="Icons.Filled.Call" />
-                <ICON name="Check" path="Icons.Filled.Check" />
-                <ICON name="CheckCircle" path="Icons.Filled.CheckCircle" />
-                <ICON name="Clear" path="Icons.Filled.Clear" />
-                <ICON name="Close" path="Icons.Filled.Close" />
-                <ICON name="Create" path="Icons.Filled.Create" />
-                <ICON name="DateRange" path="Icons.Filled.DateRange" />
-                <ICON name="Delete" path="Icons.Filled.Delete" />
-                <ICON name="Done" path="Icons.Filled.Done" />
-                <ICON name="Edit" path="Icons.Filled.Edit" />
-                <ICON name="Email" path="Icons.Filled.Email" />
-                <ICON name="ExitToApp" path="Icons.AutoMirrored.Filled.ExitToApp" note="Использовать AutoMirrored версию" />
-                <ICON name="Face" path="Icons.Filled.Face" />
-                <ICON name="Favorite" path="Icons.Filled.Favorite" />
-                <ICON name="FavoriteBorder" path="Icons.Filled.FavoriteBorder" />
-                <ICON name="Home" path="Icons.Filled.Home" />
-                <ICON name="Info" path="Icons.AutoMirrored.Filled.Info" note="Использовать AutoMirrored версию" />
-                <ICON name="KeyboardArrowDown" path="Icons.Filled.KeyboardArrowDown" />
-                <ICON name="KeyboardArrowLeft" path="Icons.AutoMirrored.Filled.KeyboardArrowLeft" note="Использовать AutoMirrored версию" />
-                <ICON name="KeyboardArrowRight" path="Icons.AutoMirrored.Filled.KeyboardArrowRight" note="Использовать AutoMirrored версию" />
-                <ICON name="KeyboardArrowUp" path="Icons.Filled.KeyboardArrowUp" />
-                <ICON name="Label" path="Icons.AutoMirrored.Filled.Label" note="Использовать AutoMirrored версию" />
-                <ICON name="List" path="Icons.AutoMirrored.Filled.List" note="Использовать AutoMirrored версию" />
-                <ICON name="LocationOn" path="Icons.Filled.LocationOn" />
-                <ICON name="Lock" path="Icons.Filled.Lock" />
-                <ICON name="MailOutline" path="Icons.Filled.MailOutline" />
-                <ICON name="Menu" path="Icons.Filled.Menu" />
-                <ICON name="MoreVert" path="Icons.Filled.MoreVert" />
-                <ICON name="Notifications" path="Icons.Filled.Notifications" />
-                <ICON name="Person" path="Icons.Filled.Person" />
-                <ICON name="Phone" path="Icons.Filled.Phone" />
-                <ICON name="Place" path="Icons.Filled.Place" />
-                <ICON name="PlayArrow" path="Icons.Filled.PlayArrow" />
-                <ICON name="Refresh" path="Icons.Filled.Refresh" />
-                <ICON name="Search" path="Icons.Filled.Search" />
-                <ICON name="Send" path="Icons.AutoMirrored.Filled.Send" note="Использовать AutoMirrored версию" />
-                <ICON name="Settings" path="Icons.Filled.Settings" />
-                <ICON name="Share" path="Icons.Filled.Share" />
-                <ICON name="ShoppingCart" path="Icons.Filled.ShoppingCart" />
-                <ICON name="Star" path="Icons.Filled.Star" />
-                <ICON name="ThumbUp" path="Icons.Filled.ThumbUp" />
-                <ICON name="Warning" path="Icons.Filled.Warning" />
-            </ICONOGRAPHY_GUIDE>
-        </PAYLOAD>
-        
-        <IMPLEMENTATION_HINTS>
-            <HINT>Найди корневой узел PROJECT_SPECIFICATION в tech_spec.txt.</HINT>
-            <HINT>Добавь новый узел ICONOGRAPHY_GUIDE в конец, после UI_SPECIFICATIONS, но перед IMPLEMENTATION_MAP.</HINT>
-            <HINT>Я уже обработал устаревшие иконки и указал правильные AutoMirrored версии, просто вставь этот блок.</HINT>
-        </IMPLEMENTATION_HINTS>
-    </WORK_ORDER>
-</TASK>```
-
-Пожалуйста, выполните эти задания последовательно, начиная с исправления ошибки. Жду вашего сигнала о результатах.

tasks/completed/01_update_label_screen_spec_status.xml

@@ -1,59 +0,0 @@
-<!-- tasks/001_update_label_screen_spec_status.xml -->
-<TASK status="completed">
-    <WORK_ORDER id="task-20250812-114001">
-        <ACTION>MODIFY_SPECIFICATION</ACTION>
-        
-        <TARGET_FILE>tech_spec.txt</TARGET_FILE>
-        <GOAL>
-            Изменить статус UI-экрана 'screen_labels_list' на 'in_progress', чтобы отразить начало работ по его реализации.
-        </GOAL>
-        
-        <CONTEXT_FILES>
-            <FILE>tech_spec.txt</FILE>
-        </CONTEXT_FILES>
-        
-        <PAYLOAD mode="UPSERT_NODE" target_node_id="screen_labels_list">
-            <SCREEN id="screen_labels_list" status="in_progress">
-                <summary>Экран "Метки"</summary>
-                <description>
-                    Отображает вертикальный список всех доступных меток. Экран должен быть интегрирован в общую структуру навигации приложения.
-                </description>
-                <LAYOUT>
-                    <COMPONENT type="TopAppBar">
-                        <description>Общая верхняя панель приложения с заголовком "Метки" и кнопкой "назад".</description>
-                    </COMPONENT>
-                    <COMPONENT type="MainContent" orientation="vertical">
-                        <description>Основная область контента, занимающая все доступное пространство под TopAppBar.</description>
-                        <SUB_COMPONENT type="List" name="LabelsList">
-                            <description>Вертикальный, прокручиваемый список (LazyColumn) всех меток.</description>
-                            <ELEMENT type="ListItem">
-                                <description>Элемент списка, представляющий одну метку. Состоит из иконки (например, 'label') и названия метки. Весь элемент является кликабельным и ведет на экран со списком предметов с данной меткой.</description>
-                            </ELEMENT>
-                        </SUB_COMPONENT>
-                    </COMPONENT>
-                    <COMPONENT type="FloatingActionButton" icon="add">
-                        <description>
-                            Плавающая кнопка действия, расположенная в правом нижнем углу. Позволяет пользователю добавить новую метку.
-                        </description>
-                    </COMPONENT>
-                </LAYOUT>
-                <USER_INTERACTIONS>
-                    <INTERACTION>
-                        <action>Нажатие на элемент списка меток</action>
-                        <reaction>Осуществляется навигация на экран списка инвентаря, отфильтрованного по выбранной метке.</reaction>
-                    </INTERACTION>
-                    <INTERACTION>
-                        <action>Нажатие на FloatingActionButton</action>
-                        <reaction>Открывается диалоговое окно или новый экран для создания новой метки.</reaction>
-                    </INTERACTION>
-                </USER_INTERACTIONS>
-            </SCREEN>
-        </PAYLOAD>
-        
-        <IMPLEMENTATION_HINTS>
-            <HINT>Найди узел SCREEN с id="screen_labels_list" в файле tech_spec.txt.</HINT>
-            <HINT>Замени атрибут status="implemented" на status="in_progress".</HINT>
-            <HINT>Не изменяй остальное содержимое узла. Просто обнови атрибут.</HINT>
-        </IMPLEMENTATION_HINTS>
-    </WORK_ORDER>
-</TASK>

tasks/completed/02_create_labels_screen_file.xml

@@ -1,92 +0,0 @@
-<!-- tasks/02_create_labels_screen_file.xml -->
-<TASK status="completed">
-    <WORK_ORDER id="task-20250812-114502">
-        <ACTION>CREATE_FILE</ACTION>
-        
-        <TARGET_FILE>app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt</TARGET_FILE>
-        
-        <GOAL>
-            Создать базовую структуру (stub) для экрана "Метки" (LabelsListScreen) с использованием Jetpack Compose.
-            Этот файл будет служить основой для дальнейшей реализации полноценного UI.
-        </GOAL>
-        
-        <CONTEXT_FILES>
-            <FILE>tech_spec.txt</FILE>
-        </CONTEXT_FILES>
-        
-        <CONTRACT>
-            <CONSTRAINTS>
-                <CONSTRAINT>Имя файла должно быть 'LabelsListScreen.kt'.</CONSTRAINT>
-                <CONSTRAINT>Функция должна называться 'LabelsListScreen'.</CONSTRAINT>
-                <CONSTRAINT>Функция должна быть аннотирована как @Composable.</CONSTRAINT>
-                <CONSTRAINT>Основная разметка должна использовать Scaffold.</CONSTRAINT>
-                <CONSTRAINT>Должен быть TopAppBar с заголовком "Метки".</CONSTRAINT>
-                <CONSTRAINT>В качестве временного контента для Scaffold должен использоваться Text-компонент с текстом "Hello, Labels Screen!".</CONSTRAINT>
-            </CONSTRAINTS>
-        </CONTRACT>
-
-        <PAYLOAD mode="FULL_CONTENT">
-        <![CDATA[
-[FILE:app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt]
-[PACKAGE]
-package com.homebox.lens.ui.screen.labelslist
-[/PACKAGE]
-
-[IMPORTS]
-import androidx.compose.foundation.layout.Box
-import androidx.compose.foundation.layout.fillMaxSize
-import androidx.compose.foundation.layout.padding
-import androidx.compose.material3.ExperimentalMaterial3Api
-import androidx.compose.material3.Scaffold
-import androidx.compose.material3.Text
-import androidx.compose.material3.TopAppBar
-import androidx.compose.runtime.Composable
-import androidx.compose.ui.Alignment
-import androidx.compose.ui.Modifier
-[/IMPORTS]
-
-[COMPOSABLE_FUNCTION]
-/**
- * Заглушка для экрана, отображающего список меток.
- * В соответствии со спецификацией 'screen_labels_list'.
- */
-@OptIn(ExperimentalMaterial3Api::class)
-@Composable
-fun LabelsListScreen(
-    // В будущем здесь будут параметры: navController для навигации, viewModel для получения данных.
-) {
-    Scaffold(
-        topBar = {
-            TopAppBar(
-                title = {
-                    Text(text = "Метки") // В будущем будет заменено на stringResource
-                }
-            )
-        }
-    ) { paddingValues ->
-        // Временный контент-заглушка.
-        // В будущем здесь будет LazyColumn для отображения списка меток.
-        Box(
-            modifier = Modifier
-                .fillMaxSize()
-                .padding(paddingValues),
-            contentAlignment = Alignment.Center
-        ) {
-            Text("Hello, Labels Screen!")
-        }
-    }
-}
-[/COMPOSABLE_FUNCTION]
-[END_FILE]
-        ]]>
-        </PAYLOAD>
-        
-        <IMPLEMENTATION_HINTS>
-            <HINT>Создай новый файл по пути 'app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt'.</HINT>
-            <HINT>Скопируй предоставленный код из секции PAYLOAD в этот файл.</HINT>
-            <HINT>Убедись, что используется правильный package: com.homebox.lens.ui.screen.labelslist.</HINT>
-            <HINT>Добавь все необходимые импорты для Jetpack Compose (Scaffold, TopAppBar, Text, Composable и т.д.), как указано в PAYLOAD.</HINT>
-            <HINT>Следуй структуре, заданной семантическими якорями.</HINT>
-        </IMPLEMENTATION_HINTS>
-    </WORK_ORDER>
-</TASK>

tasks/completed/20250813_080300_implement_labels_screen.xml

@@ -1,237 +0,0 @@
-<!-- tasks/20250813_080300_implement_labels_screen.xml -->
-<TASK status="completed">
-    <WORK_ORDER id="task-20250813080300-001">
-        <ACTION>MODIFY_CODE</ACTION>
-        
-        <TARGET_FILE>app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt</TARGET_FILE>
-        
-        <GOAL>
-            Реализовать UI для экрана "Метки" (`LabelsListScreen`) в соответствии со спецификацией `screen_labels_list`.
-            Это включает в себя создание Composable-функции, которая:
-            1. Использует `Scaffold` с `TopAppBar` и `FloatingActionButton`.
-            2. Получает состояние (список меток, статус загрузки, ошибки) от `LabelsListViewModel`.
-            3. Отображает список меток с помощью `LazyColumn`.
-            4. Обрабатывает клики по элементам списка для навигации на экран инвентаря с фильтром по метке.
-            5. Обрабатывает нажатие на FAB для создания новой метки (пока что через лог).
-            6. Отображает индикатор загрузки и сообщения об ошибках или пустом списке.
-            7. Строго следует принципам Design by Contract, использует иконки из гайда и строки из ресурсов.
-        </GOAL>
-        
-        <CONTEXT_FILES>
-            <FILE>PROJECT_SPECIFICATION.xml</FILE>
-            <FILE>PROJECT_STRUCTURE.xml</FILE>
-            <FILE>app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt</FILE>
-            <FILE>domain/src/main/java/com/homebox/lens/domain/model/Label.kt</FILE>
-            <FILE>app/src/main/java/com/homebox/lens/navigation/Screen.kt</FILE>
-        </CONTEXT_FILES>
-        
-        <CONTRACT>
-            <![CDATA[
-// [PACKAGE] com.homebox.lens.ui.screen.labelslist
-// [FILE] app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt
-
-// [IMPORTS]
-import androidx.compose.foundation.clickable
-import androidx.compose.foundation.layout.Arrangement
-import androidx.compose.foundation.layout.Box
-import androidx.compose.foundation.layout.PaddingValues
-import androidx.compose.foundation.layout.fillMaxSize
-import androidx.compose.foundation.layout.padding
-import androidx.compose.foundation.lazy.LazyColumn
-import androidx.compose.foundation.lazy.items
-import androidx.compose.material.icons.Icons
-import androidx.compose.material.icons.automirrored.filled.ArrowBack
-import androidx.compose.material.icons.automirrored.filled.Label
-import androidx.compose.material.icons.filled.Add
-import androidx.compose.material3.CircularProgressIndicator
-import androidx.compose.material3.ExperimentalMaterial3Api
-import androidx.compose.material3.FloatingActionButton
-import androidx.compose.material3.Icon
-import androidx.compose.material3.IconButton
-import androidx.compose.material3.ListItem
-import androidx.compose.material3.Scaffold
-import androidx.compose.material3.Text
-import androidx.compose.material3.TopAppBar
-import androidx.compose.runtime.Composable
-import androidx.compose.runtime.collectAsState
-import androidx.compose.runtime.getValue
-import androidx.compose.ui.Alignment
-import androidx.compose.ui.Modifier
-import androidx.compose.ui.res.stringResource
-import androidx.compose.ui.unit.dp
-import androidx.hilt.navigation.compose.hiltViewModel
-import androidx.navigation.NavController
-import com.homebox.lens.R
-import com.homebox.lens.domain.model.Label
-import timber.log.Timber
-
-// [CONTRACT]
-/**
- * [CONTRACT]
- * Отображает экран со списком всех меток.
- *
- * @param navController Контроллер навигации для перемещения между экранами.
- * @param viewModel ViewModel, предоставляющая состояние UI для экрана меток.
- *
- * @precondition `navController` должен быть корректно инициализирован и способен обрабатывать навигационные события.
- * @precondition `viewModel` должен быть доступен через Hilt.
- * @postcondition Экран отображает список меток или соответствующее состояние (загрузка, ошибка, пустой список).
- * @sideeffect Пользовательские действия (клики) инициируют навигационные команды через `navController` или логируются.
- */
-@OptIn(ExperimentalMaterial3Api::class)
-@Composable
-fun LabelsListScreen(
-    navController: NavController,
-    viewModel: LabelsListViewModel = hiltViewModel()
-) {
-    // [ACTION]
-    val uiState by viewModel.uiState.collectAsState()
-    val logger = Timber.tag("LabelsListScreen")
-
-    Scaffold(
-        topBar = {
-            TopAppBar(
-                title = { Text(text = stringResource(id = R.string.screen_title_labels)) },
-                navigationIcon = {
-                    IconButton(onClick = {
-                        logger.info { "[ACTION] Navigate up initiated." }
-                        navController.navigateUp()
-                    }) {
-                        Icon(
-                            imageVector = Icons.AutoMirrored.Filled.ArrowBack,
-                            contentDescription = stringResource(id = R.string.content_desc_navigate_back)
-                        )
-                    }
-                }
-            )
-        },
-        floatingActionButton = {
-            FloatingActionButton(onClick = {
-                // [ACTION]
-                // TODO: Открыть диалог или экран создания метки
-                logger.info { "[ACTION] FAB clicked: Initiate create new label flow." }
-            }) {
-                Icon(
-                    imageVector = Icons.Filled.Add,
-                    contentDescription = stringResource(id = R.string.content_desc_create_label)
-                )
-            }
-        }
-    ) { paddingValues ->
-        // [CORE-LOGIC]
-        Box(
-            modifier = Modifier
-                .fillMaxSize()
-                .padding(paddingValues),
-            contentAlignment = Alignment.Center
-        ) {
-            when {
-                uiState.isLoading -> {
-                    // [STATE_BRANCH] Loading
-                    CircularProgressIndicator()
-                }
-                uiState.error != null -> {
-                    // [STATE_BRANCH] Error
-                    Text(text = uiState.error ?: stringResource(id = R.string.error_unknown))
-                }
-                uiState.labels.isEmpty() -> {
-                    // [STATE_BRANCH] Empty
-                    Text(text = stringResource(id = R.string.labels_list_empty))
-                }
-                else -> {
-                    // [STATE_BRANCH] Success
-                    LabelsList(
-                        labels = uiState.labels,
-                        onLabelClick = { label ->
-                            // [ACTION]
-                            // TODO: Реализовать навигацию на экран инвентаря с фильтром
-                            logger.info { "[ACTION] Label clicked: ${label.id}. Navigating to inventory list." }
-                            // navController.navigate(Screen.InventoryList.withFilter("label", label.id))
-                        }
-                    )
-                }
-            }
-        }
-    }
-    // [COHERENCE_CHECK_PASSED]
-}
-// [END_FUNCTION] LabelsListScreen
-
-// [HELPER]
-/**
- * [CONTRACT]
- * Composable-функция для отображения списка меток.
- *
- * @param labels Список объектов `Label` для отображения.
- * @param onLabelClick Лямбда-функция, вызываемая при нажатии на элемент списка.
- *
- * @precondition `labels` не должен быть null.
- * @postcondition Отображается вертикальный прокручиваемый список.
- */
-@Composable
-private fun LabelsList(
-    labels: List<Label>,
-    onLabelClick: (Label) -> Unit,
-    modifier: Modifier = Modifier
-) {
-    // [CORE-LOGIC]
-    LazyColumn(
-        modifier = modifier.fillMaxSize(),
-        contentPadding = PaddingValues(16.dp),
-        verticalArrangement = Arrangement.spacedBy(8.dp)
-    ) {
-        items(labels) { label ->
-            LabelListItem(
-                label = label,
-                onClick = { onLabelClick(label) }
-            )
-        }
-    }
-}
-// [END_FUNCTION] LabelsList
-
-// [HELPER]
-/**
- * [CONTRACT]
- * Composable-функция для отображения одного элемента в списке меток.
- *
- * @param label Объект `Label`, который нужно отобразить.
- * @param onClick Лямбда-функция, вызываемая при нажатии на элемент.
- *
- * @precondition `label` не должен быть null.
- * @postcondition Отображается кликабельный элемент списка с иконкой и названием метки.
- */
-@Composable
-private fun LabelListItem(
-    label: Label,
-    onClick: () -> Unit
-) {
-    // [CORE-LOGIC]
-    ListItem(
-        headlineContent = { Text(text = label.name) },
-        leadingContent = {
-            Icon(
-                imageVector = Icons.AutoMirrored.Filled.Label,
-                contentDescription = stringResource(id = R.string.content_desc_label_icon)
-            )
-        },
-        modifier = Modifier.clickable(onClick = onClick)
-    )
-}
-// [END_FUNCTION] LabelListItem
-
-// [END_FILE] LabelsListScreen.kt
-            ]]>
-        </CONTRACT>
-
-        <IMPLEMENTATION_HINTS>
-            <HINT>Используйте `@HiltViewModel` для получения экземпляра `LabelsListViewModel`.</HINT>
-            <HINT>Собирайте `uiState` из ViewModel с помощью `collectAsState()` для автоматического обновления UI при изменении состояния.</HINT>
-            <HINT>Используйте `Scaffold` для базовой структуры экрана (TopAppBar, FAB, основное содержимое).</HINT>
-            <HINT>Для навигации назад используйте `navController.navigateUp()`.</HINT>
-            <HINT>Используйте `LazyColumn` для эффективного отображения потенциально длинных списков меток.</HINT>
-            <HINT>Обязательно добавьте новые строковые ресурсы (`screen_title_labels`, `content_desc_navigate_back`, `content_desc_create_label`, `labels_list_empty`, `content_desc_label_icon`) в `strings.xml`.</HINT>
-            <HINT>Иконки должны браться из `androidx.compose.material.icons` в соответствии с `ICONOGRAPHY_GUIDE`.</HINT>
-        </IMPLEMENTATION_HINTS>
-    </WORK_ORDER>
-</TASK>

tech_spec/PROJECT_MANIFEST.xml

@@ -231,6 +231,21 @@
             <description>Содержит поля: totalItems, totalValue, locationsCount, labelsCount.</description>
         </NODE>
 
+        <NODE id="model_location_create" type="data_model" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/model/LocationCreate.kt">
+            <summary>Модель для создания нового местоположения.</summary>
+            <description>Содержит поля: name, color.</description>
+        </NODE>
+
+        <NODE id="model_location_update" type="data_model" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/model/LocationUpdate.kt">
+            <summary>Модель для обновления существующего местоположения.</summary>
+            <description>Содержит поля: name, color.</description>
+        </NODE>
+
+        <NODE id="model_label_update" type="data_model" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/model/LabelUpdate.kt">
+            <summary>Модель для обновления существующей метки.</summary>
+            <description>Содержит поля: name, color.</description>
+        </NODE>
+
         <!-- Repository Interfaces -->
         <NODE id="repo_interface" type="repository_interface" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/repository/ItemRepository.kt">
             <summary>Интерфейс, определяющий контракт для операций с данными, связанными с товарами, метками и местоположениями.</summary>
@@ -246,6 +261,9 @@
                 <EDGE type="DEPENDS_ON" target_id="model_label_create"/>
                 <EDGE type="DEPENDS_ON" target_id="model_location"/>
                 <EDGE type="DEPENDS_ON" target_id="model_result"/>
+                <EDGE type="DEPENDS_ON" target_id="model_location_create"/>
+                <EDGE type="DEPENDS_ON" target_id="model_location_update"/>
+                <EDGE type="DEPENDS_ON" target_id="model_label_update"/>
             </RELATIONS>
         </NODE>
         <NODE id="func_get_location_details" type="function" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/repository/ItemRepository.kt">
@@ -289,6 +307,12 @@
                 <EDGE type="DEPENDS_ON" target_id="repo_interface"/>
             </RELATIONS>
         </NODE>
+        <NODE id="uc_update_item" type="use_case" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/usecase/UpdateItemUseCase.kt">
+            <summary>Сценарий использования для обновления существующего товара.</summary>
+            <RELATIONS>
+                <EDGE type="DEPENDS_ON" target_id="repo_interface"/>
+            </RELATIONS>
+        </NODE>
         <NODE id="uc_create_label" type="use_case" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/usecase/CreateLabelUseCase.kt">
             <summary>Сценарий использования для создания новой метки.</summary>
             <RELATIONS>
@@ -344,6 +368,41 @@
             </RELATIONS>
         </NODE>
 
+        <NODE id="uc_create_location" type="use_case" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/usecase/CreateLocationUseCase.kt">
+            <summary>Сценарий использования для создания нового местоположения.</summary>
+            <RELATIONS>
+                <EDGE type="DEPENDS_ON" target_id="repo_interface"/>
+            </RELATIONS>
+        </NODE>
+
+        <NODE id="uc_update_location" type="use_case" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/usecase/UpdateLocationUseCase.kt">
+            <summary>Сценарий использования для обновления существующего местоположения.</summary>
+            <RELATIONS>
+                <EDGE type="DEPENDS_ON" target_id="repo_interface"/>
+            </RELATIONS>
+        </NODE>
+
+        <NODE id="uc_delete_location" type="use_case" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/usecase/DeleteLocationUseCase.kt">
+            <summary>Сценарий использования для удаления местоположения.</summary>
+            <RELATIONS>
+                <EDGE type="DEPENDS_ON" target_id="repo_interface"/>
+            </RELATIONS>
+        </NODE>
+
+        <NODE id="uc_update_label" type="use_case" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/usecase/UpdateLabelUseCase.kt">
+            <summary>Сценарий использования для обновления существующей метки.</summary>
+            <RELATIONS>
+                <EDGE type="DEPENDS_ON" target_id="repo_interface"/>
+            </RELATIONS>
+        </NODE>
+
+        <NODE id="uc_delete_label" type="use_case" status="implemented" file_path="domain/src/main/java/com/homebox/lens/domain/usecase/DeleteLabelUseCase.kt">
+            <summary>Сценарий использования для удаления метки.</summary>
+            <RELATIONS>
+                <EDGE type="DEPENDS_ON" target_id="repo_interface"/>
+            </RELATIONS>
+        </NODE>
+
         <!-- ================================================================================== -->
         <!--                                  УЗЛЫ СЛОЯ DATA                                    -->
         <!-- ================================================================================== -->
@@ -444,7 +503,7 @@
                 <EDGE type="HAS_VIEWMODEL" target_id="vm_item_details"/>
             </RELATIONS>
         </NODE>
-        <NODE id="screen_item_edit" type="ui_screen" status="stub" file_path="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt">
+        <NODE id="screen_item_edit" type="ui_screen" status="implemented" file_path="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt">
             <summary>Экран создания/редактирования товара</summary>
             <description>Позволяет пользователям создавать новые товары или редактировать существующие.</description>
             <RELATIONS>
@@ -499,7 +558,7 @@
                 <EDGE type="CALLS" target_id="uc_get_item_details"/>
             </RELATIONS>
         </NODE>
-        <NODE id="vm_item_edit" type="view_model" status="stub" file_path="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt">
+        <NODE id="vm_item_edit" type="view_model" status="implemented" file_path="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt">
             <summary>ViewModel для экрана создания/редактирования товара.</summary>
             <RELATIONS>
                 <EDGE type="CALLS" target_id="uc_create_item"/>

tech_spec/project_structure.txt

@@ -1,191 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<PROJECT_STRUCTURE>
-    <module name="app" type="android_app">
-        <purpose_summary>Основной модуль приложения, содержит UI и точки входа в приложение.</purpose_summary>
-        <coherence_note>Этот модуль зависит от data и domain; обеспечивает разделение UI от бизнес-логики через ViewModels и UseCases.</coherence_note>
-        <file name="app/src/main/java/com/homebox/lens/MainActivity.kt" status="implemented" spec_ref_id="entry_point">
-            <purpose_summary>Главная и единственная Activity приложения, содержит NavHost.</purpose_summary>
-            <coherence_note>Интегрирован с Hilt для DI; навигация через Compose Navigation.</coherence_note>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/MainApplication.kt" status="implemented" spec_ref_id="app_context">
-            <purpose_summary>Класс Application, используется для настройки внедрения зависимостей Hilt.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/di/AppModule.kt" status="implemented" spec_ref_id="di_app">
-            <purpose_summary>Модуль Hilt для зависимостей уровня приложения.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/navigation/NavGraph.kt" status="implemented" spec_ref_id="nav_graph">
-            <purpose_summary>Определяет навигационный граф для всего приложения с использованием Jetpack Compose Navigation.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/navigation/Screen.kt" status="implemented" spec_ref_id="nav_screen">
-            <purpose_summary>Определяет маршруты для всех экранов в приложении в виде запечатанного класса.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt" status="implemented" spec_ref_id="screen_dashboard">
-            <purpose_summary>UI для экрана панели управления.</purpose_summary>
-            <coherence_note>Использует Compose для declarative UI; интегрирован с ViewModel для данных.</coherence_note>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModel.kt" status="implemented" spec_ref_id="screen_dashboard">
-            <purpose_summary>ViewModel для экрана панели управления, обрабатывает бизнес-логику.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListScreen.kt" status="stub" spec_ref_id="screen_inventory_list">
-            <purpose_summary>UI для экрана списка инвентаря.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListViewModel.kt" status="implemented" spec_ref_id="screen_inventory_list">
-            <purpose_summary>ViewModel для экрана списка инвентаря.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsScreen.kt" status="stub" spec_ref_id="screen_item_details">
-            <purpose_summary>UI для экрана сведений о товаре.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsViewModel.kt" status="implemented" spec_ref_id="screen_item_details">
-            <purpose_summary>ViewModel для экрана сведений о товаре.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt" status="stub" spec_ref_id="screen_item_edit">
-            <purpose_summary>UI для экрана редактирования товара.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt" status="implemented" spec_ref_id="screen_item_edit">
-            <purpose_summary>ViewModel для экрана редактирования товара.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt" status="stub" spec_ref_id="screen_labels_list">
-            <purpose_summary>UI для экрана списка меток.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt" status="implemented" spec_ref_id="screen_labels_list">
-            <purpose_summary>ViewModel для экрана списка меток.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListScreen.kt" status="implemented" spec_ref_id="screen_locations_list">
-            <purpose_summary>UI для экрана списка местоположений.</purpose_summary>
-            <coherence_note>Использует модель LocationOutCount для отображения количества элементов в каждой локации.</coherence_note>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListViewModel.kt" status="implemented" spec_ref_id="screen_locations_list">
-            <purpose_summary>ViewModel для экрана списка местоположений.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/search/SearchScreen.kt" status="stub" spec_ref_id="screen_search">
-            <purpose_summary>UI для экрана поиска.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/search/SearchViewModel.kt" status="implemented" spec_ref_id="screen_search">
-            <purpose_summary>ViewModel для экрана поиска.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt" status="stub" spec_ref_id="screen_setup">
-            <purpose_summary>UI для экрана настройки.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt" status="implemented" spec_ref_id="screen_setup">
-            <purpose_summary>ViewModel для экрана настройки.</purpose_summary>
-        </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupUiState.kt" status="implemented" spec_ref_id="screen_setup">
-            <purpose_summary>Состояние UI для экрана настройки.</purpose_summary>
-        </file>
-    </module>
-    <module name="data" type="android_library">
-        <purpose_summary>Слой данных, отвечающий за источники данных (сеть, локальная БД) и реализации репозиториев.</purpose_summary>
-        <coherence_note>Интегрирует Retrofit для API и Room для локального хранения; обеспечивает оффлайн-поддержку.</coherence_note>
-        <file name="data/src/main/java/com/homebox/lens/data/api/HomeboxApiService.kt" status="implemented" spec_ref_id="api_service">
-            <purpose_summary>Интерфейс сервиса Retrofit для Homebox API.</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/db/HomeboxDatabase.kt" status="implemented" spec_ref_id="database">
-            <purpose_summary>Определение базы данных Room для локального кэширования.</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/repository/ItemRepositoryImpl.kt" status="implemented" spec_ref_id="repo_impl">
-            <purpose_summary>Реализация ItemRepository, координирующая данные из API и локальной БД.</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/di/ApiModule.kt" status="implemented" spec_ref_id="di_api">
-            <purpose_summary>Модуль Hilt для предоставления зависимостей, связанных с сетью (Retrofit, OkHttp).</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/di/DatabaseModule.kt" status="implemented" spec_ref_id="di_db">
-            <purpose_summary>Модуль Hilt для предоставления зависимостей, связанных с базой данных (Room DB, DAO).</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/di/RepositoryModule.kt" status="implemented" spec_ref_id="di_repo">
-            <purpose_summary>Модуль Hilt для привязки интерфейсов репозиториев к их реализациям.</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/di/StorageModule.kt" status="implemented" spec_ref_id="di_storage">
-            <purpose_summary>Модуль Hilt для предоставления зависимостей, связанных с хранилищем (EncryptedSharedPreferences).</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/repository/CredentialsRepositoryImpl.kt" status="implemented" spec_ref_id="repo_credentials_impl">
-            <purpose_summary>Реализация CredentialsRepository.</purpose_summary>
-        </file>
-        <file name="data/src/main/java/com/homebox/lens/data/repository/AuthRepositoryImpl.kt" status="implemented" spec_ref_id="repo_auth_impl">
-            <purpose_summary>Реализация AuthRepository.</purpose_summary>
-        </file>
-    </module>
-    <module name="domain" type="kotlin_jvm_library">
-        <purpose_summary>Доменный слой, содержит бизнес-логику, сценарии использования и интерфейсы репозиториев. Чистый модуль Kotlin.</purpose_summary>
-        <coherence_note>Чистая бизнес-логика без зависимостей от Android; использует корутины для async.</coherence_note>
-        <file name="domain/src/main/java/com/homebox/lens/domain/model/Credentials.kt" status="implemented" spec_ref_id="model_credentials">
-            <purpose_summary>Класс данных для хранения учетных данных пользователя.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/repository/AuthRepository.kt" status="implemented" spec_ref_id="repo_auth_interface">
-            <purpose_summary>Интерфейс для репозитория аутентификации.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/repository/CredentialsRepository.kt" status="implemented" spec_ref_id="repo_credentials_interface">
-            <purpose_summary>Интерфейс для репозитория учетных данных.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/repository/ItemRepository.kt" status="implemented" spec_ref_id="repo_interface">
-            <purpose_summary>Интерфейс, определяющий контракт для операций с данными, связанными с товарами.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/LoginUseCase.kt" status="implemented" spec_ref_id="uc_login">
-            <purpose_summary>Сценарий использования для входа пользователя.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/CreateItemUseCase.kt" status="implemented" spec_ref_id="uc_create_item">
-            <purpose_summary>Сценарий использования для создания нового товара.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/DeleteItemUseCase.kt" status="implemented" spec_ref_id="uc_delete_item">
-            <purpose_summary>Сценарий использования для удаления товара.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/GetAllLabelsUseCase.kt" status="implemented" spec_ref_id="uc_get_all_labels">
-            <purpose_summary>Сценарий использования для получения всех меток.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/GetAllLocationsUseCase.kt" status="implemented" spec_ref_id="uc_get_all_locations">
-            <purpose_summary>Сценарий использования для получения всех местоположений со счетчиками элементов.</purpose_summary>
-            <coherence_note>Возвращает List<LocationOutCount>, а не базовую модель Location.</coherence_note>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/GetItemDetailsUseCase.kt" status="implemented" spec_ref_id="uc_get_item_details">
-            <purpose_summary>Сценарий использования для получения сведений о конкретном товаре.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/GetRecentlyAddedItemsUseCase.kt" status="implemented" spec_ref_id="uc_get_recent_items">
-            <purpose_summary>Сценарий использования для получения недавно добавленных товаров.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/GetStatisticsUseCase.kt" status="implemented" spec_ref_id="uc_get_stats">
-            <purpose_summary>Сценарий использования для получения статистики по инвентарю.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/SearchItemsUseCase.kt" status="implemented" spec_ref_id="uc_search_items">
-            <purpose_summary>Сценарий использования для поиска товаров.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/SyncInventoryUseCase.kt" status="implemented" spec_ref_id="uc_sync_inventory">
-            <purpose_summary>Сценарий использования для синхронизации локального инвентаря с удаленным сервером.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/usecase/UpdateItemUseCase.kt" status="implemented" spec_ref_id="uc_update_item">
-            <purpose_summary>Сценарий использования для обновления существующего товара.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/model/Item.kt" status="implemented" spec_ref_id="model_item">
-            <purpose_summary>Модель инвентарного товара.</purpose_summary>
-            <coherence_note>Data class с полями для контрактов; используется в UseCases и Repo.</coherence_note>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/model/Label.kt" status="implemented" spec_ref_id="model_label">
-            <purpose_summary>Модель метки.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/model/Location.kt" status="implemented" spec_ref_id="model_location">
-            <purpose_summary>Модель местоположения.</purpose_summary>
-        </file>
-        <file name="domain/src/main/java/com/homebox/lens/domain/model/Statistics.kt" status="implemented" spec_ref_id="model_statistics">
-            <purpose_summary>Модель статистики инвентаря.</purpose_summary>
-        </file>
-    </module>
-    <module name="app-test" type="android_test">
-        <purpose_summary>Модуль для unit и integration тестов приложения.</purpose_summary>
-        <coherence_note>Тесты основаны на контрактах из DbC; используют Kotest для assertions.</coherence_note>
-        <file name="app/src/test/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModelTest.kt" status="implemented" spec_ref_id="screen_dashboard">
-            <purpose_summary>Unit-тесты для DashboardViewModel.</purpose_summary>
-            <coherence_note>Проверяет постусловия GetStatisticsUseCase.</coherence_note>
-        </file>
-        <file name="app/src/test/java/com/homebox/lens/navigation/NavGraphTest.kt" status="implemented" spec_ref_id="nav_graph">
-            <purpose_summary>Тесты навигационного графа.</purpose_summary>
-        </file>
-    </module>
-    <module name="domain-test" type="kotlin_test">
-        <purpose_summary>Модуль для unit-тестов доменного слоя.</purpose_summary>
-        <file name="domain/src/test/java/com/homebox/lens/domain/usecase/GetStatisticsUseCaseTest.kt" status="implemented" spec_ref_id="uc_get_stats">
-            <purpose_summary>Unit-тесты для GetStatisticsUseCase.</purpose_summary>
-            <coherence_note>Включает тесты на edge cases и нарушения контрактов.</coherence_note>
-        </file>
-        <file name="domain/src/test/java/com/homebox/lens/domain/model/ItemTest.kt" status="implemented" spec_ref_id="model_item">
-            <purpose_summary>Тесты модели Item.</purpose_summary>
-        </file>
-    </module>
-</PROJECT_STRUCTURE>