generate semantic clean up

.ai/MODULE_MAP.md

@@ -2,40 +2,15 @@
 
 > High-level module structure for AI Context. Generated automatically.
 
-**Generated:** 2026-02-23T14:44:08.540853
+**Generated:** 2026-02-24T12:45:07.897362
 
 ## Summary
 
-- **Total Modules:** 70
-- **Total Entities:** 1337
+- **Total Modules:** 72
+- **Total Entities:** 1517
 
 ## Module Hierarchy
 
-  ### 📁 `shots/`
-
-  - 🏗️ **Layers:** Domain (Business Logic), Domain (Core), Interface (API), UI (Presentation)
-  - 📊 **Tiers:** CRITICAL: 2, STANDARD: 7, TRIVIAL: 1
-  - 📄 **Files:** 4
-  - 📦 **Entities:** 10
-
-  **Key Entities:**
-
-    - 🧩 **FrontendComponentShot** (Component) `[CRITICAL]`
-      - Action button to spawn a new task with full UX feedback cycl...
-    - 📦 **BackendRouteShot** (Module)
-      - Reference implementation of a task-based route using GRACE-P...
-    - 📦 **PluginExampleShot** (Module)
-      - Reference implementation of a plugin following GRACE standar...
-    - 📦 **TransactionCore** (Module) `[CRITICAL]`
-      - Core banking transaction processor with ACID guarantees.
-
-  **Dependencies:**
-
-    - 🔗 DEPENDS_ON -> [DEF:Infra:AuditLog]
-    - 🔗 DEPENDS_ON -> [DEF:Infra:PostgresDB]
-    - 🔗 IMPLEMENTS -> [DEF:Std:API_FastAPI]
-    - 🔗 INHERITS -> PluginBase
-
 ### 📁 `backend/`
 
 - 🏗️ **Layers:** Unknown, Utility
@@ -78,13 +53,19 @@
 
       ### 📁 `routes/`
 
-      - 🏗️ **Layers:** API, UI (API), Unknown
-      - 📊 **Tiers:** CRITICAL: 2, STANDARD: 140, TRIVIAL: 3
-      - 📄 **Files:** 16
-      - 📦 **Entities:** 145
+      - 🏗️ **Layers:** API, UI (API)
+      - 📊 **Tiers:** CRITICAL: 2, STANDARD: 181, TRIVIAL: 4
+      - 📄 **Files:** 17
+      - 📦 **Entities:** 187
 
       **Key Entities:**
 
+        - ℂ **AssistantAction** (Class) `[TRIVIAL]`
+          - UI action descriptor returned with assistant responses.
+        - ℂ **AssistantMessageRequest** (Class) `[TRIVIAL]`
+          - Input payload for assistant message endpoint.
+        - ℂ **AssistantMessageResponse** (Class)
+          - Output payload contract for assistant interaction endpoints.
         - ℂ **BranchCheckout** (Class)
           - Schema for branch checkout requests.
         - ℂ **BranchCreate** (Class)
@@ -95,15 +76,10 @@
           - Schema for staging and committing changes.
         - ℂ **CommitSchema** (Class)
           - Schema for representing Git commit details.
+        - ℂ **ConfirmationRecord** (Class)
+          - In-memory confirmation token model for risky operation dispa...
         - ℂ **ConflictResolution** (Class)
           - Schema for resolving merge conflicts.
-        - ℂ **ConnectionCreate** (Class)
-          - Pydantic model for creating a connection.
-        - ℂ **ConnectionSchema** (Class)
-          - Pydantic model for connection response.
-        - ℂ **ConsolidatedSettingsResponse** (Class)
-        - ℂ **DeployRequest** (Class)
-          - Schema for dashboard deployment requests.
 
       **Dependencies:**
 
@@ -111,38 +87,52 @@
         - 🔗 DEPENDS_ON -> ConfigModels
         - 🔗 DEPENDS_ON -> backend.src.core.database
         - 🔗 DEPENDS_ON -> backend.src.core.superset_client
-        - 🔗 DEPENDS_ON -> backend.src.dependencies
+        - 🔗 DEPENDS_ON -> backend.src.core.task_manager
 
         ### 📁 `__tests__/`
 
-        - 🏗️ **Layers:** API, Domain (Tests)
-        - 📊 **Tiers:** CRITICAL: 3, STANDARD: 16, TRIVIAL: 22
-        - 📄 **Files:** 5
-        - 📦 **Entities:** 41
+        - 🏗️ **Layers:** API, Domain (Tests), UI (API Tests)
+        - 📊 **Tiers:** CRITICAL: 3, STANDARD: 33, TRIVIAL: 81
+        - 📄 **Files:** 7
+        - 📦 **Entities:** 117
 
         **Key Entities:**
 
-          - 📦 **backend.src.api.routes.__tests__.test_dashboards** (Module)
-            - Unit tests for Dashboards API endpoints
-          - 📦 **backend.src.api.routes.__tests__.test_datasets** (Module)
-            - Unit tests for Datasets API endpoints
-          - 📦 **backend.tests.test_reports_api** (Module) `[CRITICAL]`
-            - Contract tests for GET /api/reports defaults, pagination, an...
-          - 📦 **backend.tests.test_reports_detail_api** (Module) `[CRITICAL]`
-            - Contract tests for GET /api/reports/{report_id} detail endpo...
-          - 📦 **backend.tests.test_reports_openapi_conformance** (Module) `[CRITICAL]`
-            - Validate implemented reports payload shape against OpenAPI-r...
+          - ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
+            - Provide deterministic environment aliases required by intent...
+          - ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
+            - Environment config fixture with dev/prod aliases for parser ...
+          - ℂ **_FakeDb** (Class) `[TRIVIAL]`
+            - In-memory session substitute for assistant route persistence...
+          - ℂ **_FakeDb** (Class) `[TRIVIAL]`
+            - In-memory fake database implementing subset of Session inter...
+          - ℂ **_FakeQuery** (Class) `[TRIVIAL]`
+            - Minimal chainable query object for fake DB interactions.
+          - ℂ **_FakeQuery** (Class) `[TRIVIAL]`
+            - Minimal chainable query object for fake SQLAlchemy-like DB b...
+          - ℂ **_FakeTask** (Class) `[TRIVIAL]`
+            - Lightweight task model used for assistant authz tests.
+          - ℂ **_FakeTask** (Class) `[TRIVIAL]`
+            - Lightweight task stub used by assistant API tests.
+          - ℂ **_FakeTaskManager** (Class) `[TRIVIAL]`
+            - Minimal task manager for deterministic operation creation an...
+          - ℂ **_FakeTaskManager** (Class) `[TRIVIAL]`
+            - Minimal async-compatible TaskManager fixture for determinist...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> backend.src.api.routes.assistant
 
     ### 📁 `core/`
 
     - 🏗️ **Layers:** Core
-    - 📊 **Tiers:** STANDARD: 112, TRIVIAL: 1
+    - 📊 **Tiers:** STANDARD: 113, TRIVIAL: 7
     - 📄 **Files:** 9
-    - 📦 **Entities:** 113
+    - 📦 **Entities:** 120
 
     **Key Entities:**
 
-      - ℂ **AuthSessionLocal** (Class)
+      - ℂ **AuthSessionLocal** (Class) `[TRIVIAL]`
         - A session factory for the authentication database.
       - ℂ **BeliefFormatter** (Class)
         - Custom logging formatter that adds belief state prefixes to ...
@@ -160,7 +150,7 @@
         - Scans a specified directory for Python modules, dynamically ...
       - ℂ **SchedulerService** (Class)
         - Provides a service to manage scheduled backup tasks.
-      - ℂ **SessionLocal** (Class)
+      - ℂ **SessionLocal** (Class) `[TRIVIAL]`
         - A session factory for the main mappings database.
 
     **Dependencies:**
@@ -168,7 +158,8 @@
       - 🔗 DEPENDS_ON -> AppConfigRecord
       - 🔗 DEPENDS_ON -> ConfigModels
       - 🔗 DEPENDS_ON -> PyYAML
-      - 🔗 DEPENDS_ON -> sqlalchemy
+      - 🔗 DEPENDS_ON -> backend.src.core.auth.config
+      - 🔗 DEPENDS_ON -> backend.src.models.mapping
 
       ### 📁 `auth/`
 
@@ -305,9 +296,9 @@
     ### 📁 `models/`
 
     - 🏗️ **Layers:** Domain, Model
-    - 📊 **Tiers:** CRITICAL: 2, STANDARD: 24, TRIVIAL: 21
-    - 📄 **Files:** 10
-    - 📦 **Entities:** 47
+    - 📊 **Tiers:** CRITICAL: 2, STANDARD: 28, TRIVIAL: 21
+    - 📄 **Files:** 11
+    - 📦 **Entities:** 51
 
     **Key Entities:**
 
@@ -315,6 +306,12 @@
         - Maps an Active Directory group to a local System Role.
       - ℂ **AppConfigRecord** (Class)
         - Stores the single source of truth for application configurat...
+      - ℂ **AssistantAuditRecord** (Class)
+        - Store audit decisions and outcomes produced by assistant com...
+      - ℂ **AssistantConfirmationRecord** (Class)
+        - Persist risky operation confirmation tokens with lifecycle s...
+      - ℂ **AssistantMessageRecord** (Class)
+        - Persist chat history entries for assistant conversations.
       - ℂ **ConnectionConfig** (Class) `[TRIVIAL]`
         - Stores credentials for external databases used for column ma...
       - ℂ **DashboardMetadata** (Class) `[TRIVIAL]`
@@ -325,18 +322,13 @@
         - Represents a mapping between source and target databases.
       - ℂ **DeploymentEnvironment** (Class) `[TRIVIAL]`
         - Target Superset environments for dashboard deployment.
-      - ℂ **Environment** (Class)
-        - Represents a Superset instance environment.
-      - ℂ **ErrorContext** (Class)
-        - Error and recovery context for failed/partial reports.
-      - ℂ **FileCategory** (Class) `[TRIVIAL]`
-        - Enumeration of supported file categories in the storage syst...
 
     **Dependencies:**
 
       - 🔗 DEPENDS_ON -> Role
       - 🔗 DEPENDS_ON -> TaskRecord
       - 🔗 DEPENDS_ON -> backend.src.core.task_manager.models
+      - 🔗 DEPENDS_ON -> backend.src.models.mapping
       - 🔗 DEPENDS_ON -> sqlalchemy
 
       ### 📁 `__tests__/`
@@ -511,9 +503,9 @@
     ### 📁 `services/`
 
     - 🏗️ **Layers:** Core, Domain, Service
-    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 50, TRIVIAL: 5
-    - 📄 **Files:** 6
-    - 📦 **Entities:** 56
+    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 58, TRIVIAL: 5
+    - 📄 **Files:** 7
+    - 📦 **Entities:** 64
 
     **Key Entities:**
 
@@ -535,29 +527,35 @@
         - Orchestrates authentication business logic.
       - 📦 **backend.src.services.git_service** (Module)
         - Core Git logic using GitPython to manage dashboard repositor...
-      - 📦 **backend.src.services.llm_provider** (Module)
-        - Service for managing LLM provider configurations with encryp...
+      - 📦 **backend.src.services.llm_prompt_templates** (Module)
+        - Provide default LLM prompt templates and normalization helpe...
 
     **Dependencies:**
 
+      - 🔗 DEPENDS_ON -> backend.src.core.config_manager
       - 🔗 DEPENDS_ON -> backend.src.core.database
       - 🔗 DEPENDS_ON -> backend.src.core.superset_client
       - 🔗 DEPENDS_ON -> backend.src.core.task_manager
       - 🔗 DEPENDS_ON -> backend.src.core.utils.matching
-      - 🔗 DEPENDS_ON -> backend.src.models.llm
 
       ### 📁 `__tests__/`
 
-      - 🏗️ **Layers:** Service
-      - 📊 **Tiers:** STANDARD: 7
-      - 📄 **Files:** 1
-      - 📦 **Entities:** 7
+      - 🏗️ **Layers:** Domain Tests, Service
+      - 📊 **Tiers:** STANDARD: 14
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 14
 
       **Key Entities:**
 
+        - 📦 **backend.src.services.__tests__.test_llm_prompt_templates** (Module)
+          - Validate normalization and rendering behavior for configurab...
         - 📦 **backend.src.services.__tests__.test_resource_service** (Module)
           - Unit tests for ResourceService
 
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> backend.src.services.llm_prompt_templates
+
       ### 📁 `reports/`
 
       - 🏗️ **Layers:** Domain
@@ -689,9 +687,9 @@
       ### 📁 `llm/`
 
       - 🏗️ **Layers:** UI, Unknown
-      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 10
+      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 11
       - 📄 **Files:** 3
-      - 📦 **Entities:** 12
+      - 📦 **Entities:** 13
 
       **Key Entities:**
 
@@ -706,6 +704,18 @@
         - 📦 **ValidationReport** (Module) `[TRIVIAL]`
           - Auto-generated module for frontend/src/components/llm/Valida...
 
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** UI Tests
+        - 📊 **Tiers:** STANDARD: 2
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 📦 **frontend.src.components.llm.__tests__.provider_config_integration** (Module)
+            - Protect edit-button interaction contract in LLM provider set...
+
       ### 📁 `storage/`
 
       - 🏗️ **Layers:** UI
@@ -784,19 +794,22 @@
 
       ### 📁 `api/`
 
-      - 🏗️ **Layers:** Infra
-      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 4
-      - 📄 **Files:** 1
-      - 📦 **Entities:** 5
+      - 🏗️ **Layers:** Infra, Infra-API
+      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 10
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 11
 
       **Key Entities:**
 
+        - 📦 **frontend.src.lib.api.assistant** (Module)
+          - API client wrapper for assistant chat, confirmation actions,...
         - 📦 **frontend.src.lib.api.reports** (Module) `[CRITICAL]`
           - Wrapper-based reports API client for list/detail retrieval w...
 
       **Dependencies:**
 
         - 🔗 DEPENDS_ON -> [DEF:api_module]
+        - 🔗 DEPENDS_ON -> frontend.src.lib.api.api_module
 
       ### 📁 `auth/`
 
@@ -810,12 +823,40 @@
         - 🗄️ **authStore** (Store)
           - Manages the global authentication state on the frontend.
 
+        ### 📁 `assistant/`
+
+        - 🏗️ **Layers:** UI, Unknown
+        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 12, TRIVIAL: 4
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 17
+
+        **Key Entities:**
+
+          - 🧩 **AssistantChatPanel** (Component) `[CRITICAL]`
+            - Slide-out assistant chat panel for natural language command ...
+          - 📦 **AssistantChatPanel** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/assist...
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** UI Tests
+          - 📊 **Tiers:** STANDARD: 5
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **frontend.src.lib.components.assistant.__tests__.assistant_chat_integration** (Module)
+              - Contract-level integration checks for assistant chat panel i...
+            - 📦 **frontend.src.lib.components.assistant.__tests__.assistant_confirmation_integration** (Module)
+              - Validate confirm/cancel UX contract bindings in assistant ch...
+
         ### 📁 `layout/`
 
         - 🏗️ **Layers:** UI, Unknown
-        - 📊 **Tiers:** CRITICAL: 3, STANDARD: 4, TRIVIAL: 26
+        - 📊 **Tiers:** CRITICAL: 3, STANDARD: 4, TRIVIAL: 27
         - 📄 **Files:** 4
-        - 📦 **Entities:** 33
+        - 📦 **Entities:** 34
 
         **Key Entities:**
 
@@ -934,9 +975,9 @@
       ### 📁 `stores/`
 
       - 🏗️ **Layers:** UI, Unknown
-      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 2, TRIVIAL: 12
-      - 📄 **Files:** 3
-      - 📦 **Entities:** 15
+      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 7, TRIVIAL: 12
+      - 📄 **Files:** 4
+      - 📦 **Entities:** 20
 
       **Key Entities:**
 
@@ -946,6 +987,8 @@
           - Auto-generated module for frontend/src/lib/stores/taskDrawer...
         - 🗄️ **activity** (Store)
           - Track active task count for navbar indicator
+        - 🗄️ **assistantChat** (Store)
+          - Control assistant chat panel visibility and active conversat...
         - 🗄️ **sidebar** (Store)
           - Manage sidebar visibility and navigation state
         - 🗄️ **taskDrawer** (Store) `[CRITICAL]`
@@ -957,13 +1000,15 @@
 
         ### 📁 `__tests__/`
 
-        - 🏗️ **Layers:** Domain (Tests), UI
-        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 8
-        - 📄 **Files:** 5
-        - 📦 **Entities:** 9
+        - 🏗️ **Layers:** Domain (Tests), UI, UI Tests
+        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 10
+        - 📄 **Files:** 6
+        - 📦 **Entities:** 11
 
         **Key Entities:**
 
+          - 📦 **frontend.src.lib.stores.__tests__.assistantChat** (Module)
+            - Validate assistant chat store visibility and conversation bi...
           - 📦 **frontend.src.lib.stores.__tests__.sidebar** (Module)
             - Unit tests for sidebar store
           - 📦 **frontend.src.lib.stores.__tests__.test_activity** (Module)
@@ -977,6 +1022,7 @@
 
         **Dependencies:**
 
+          - 🔗 DEPENDS_ON -> assistantChatStore
           - 🔗 DEPENDS_ON -> frontend.src.lib.stores.taskDrawer
 
           ### 📁 `mocks/`
@@ -1076,9 +1122,9 @@
           ### 📁 `llm/`
 
           - 🏗️ **Layers:** UI, Unknown
-          - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
+          - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 5
           - 📄 **Files:** 1
-          - 📦 **Entities:** 3
+          - 📦 **Entities:** 6
 
           **Key Entities:**
 
@@ -1189,9 +1235,9 @@
       ### 📁 `settings/`
 
       - 🏗️ **Layers:** UI, Unknown
-      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 10
+      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 14
       - 📄 **Files:** 2
-      - 📦 **Entities:** 12
+      - 📦 **Entities:** 16
 
       **Key Entities:**
 
@@ -1355,14 +1401,18 @@ graph TD
     routes-->|DEPENDS_ON|backend
     routes-->|DEPENDS_ON|backend
     routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
     __tests__-->|TESTS|backend
     __tests__-->|TESTS|backend
     __tests__-->|TESTS|backend
     __tests__-->|TESTS|backend
+    __tests__-->|DEPENDS_ON|backend
+    __tests__-->|DEPENDS_ON|backend
     core-->|USES|backend
     core-->|USES|backend
-    core-->|USES|backend
-    core-->|USES|backend
+    core-->|DEPENDS_ON|backend
+    core-->|DEPENDS_ON|backend
     auth-->|USES|backend
     auth-->|USES|backend
     auth-->|USES|backend
@@ -1372,6 +1422,7 @@ graph TD
     utils-->|DEPENDS_ON|backend
     models-->|INHERITS_FROM|backend
     models-->|DEPENDS_ON|backend
+    models-->|DEPENDS_ON|backend
     models-->|USED_BY|backend
     models-->|INHERITS_FROM|backend
     llm_analysis-->|IMPLEMENTS|backend
@@ -1390,11 +1441,13 @@ graph TD
     services-->|DEPENDS_ON|backend
     services-->|DEPENDS_ON|backend
     services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
     services-->|USES|backend
     services-->|USES|backend
     services-->|USES|backend
     services-->|DEPENDS_ON|backend
     services-->|DEPENDS_ON|backend
+    __tests__-->|DEPENDS_ON|backend
     __tests__-->|TESTS|backend
     reports-->|DEPENDS_ON|backend
     reports-->|DEPENDS_ON|backend
@@ -1405,6 +1458,9 @@ graph TD
     reports-->|DEPENDS_ON|backend
     __tests__-->|TESTS|backend
     tests-->|TESTS|backend
+    __tests__-->|VERIFIES|components
+    __tests__-->|VERIFIES|lib
+    __tests__-->|VERIFIES|lib
     reports-->|DEPENDS_ON|lib
     __tests__-->|TESTS|routes
     __tests__-->|TESTS|routes

.ai/PROJECT_MAP.md

@@ -79,43 +79,6 @@
         - 📝 Flattens entity tree for easier grouping.
   - ƒ **to_dict** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- 📦 **TransactionCore** (`Module`) `[CRITICAL]`
-  - 📝 Core banking transaction processor with ACID guarantees.
-  - 🏗️ Layer: Domain (Core)
-  - 🔒 Invariant: Negative transfers are strictly forbidden.
-  - 🔗 DEPENDS_ON -> `[DEF:Infra:PostgresDB]`
-  - 🔗 DEPENDS_ON -> `[DEF:Infra:AuditLog]`
-  - ƒ **execute_transfer** (`Function`)
-    - 📝 Atomically move funds between accounts with audit trails.
-    - 🔗 CALLS -> `atomic_transaction`
-- 📦 **PluginExampleShot** (`Module`)
-  - 📝 Reference implementation of a plugin following GRACE standards.
-  - 🏗️ Layer: Domain (Business Logic)
-  - 🔒 Invariant: get_schema must return valid JSON Schema.
-  - 🔗 INHERITS -> `PluginBase`
-  - ƒ **get_schema** (`Function`)
-    - 📝 Defines input validation schema.
-  - ƒ **execute** (`Function`)
-    - 📝 Core plugin logic with structured logging and scope isolation.
-  - ƒ **id** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-- 📦 **BackendRouteShot** (`Module`)
-  - 📝 Reference implementation of a task-based route using GRACE-Poly.
-  - 🏗️ Layer: Interface (API)
-  - 🔒 Invariant: TaskManager must be available in dependency graph.
-  - 🔗 IMPLEMENTS -> `[DEF:Std:API_FastAPI]`
-  - ƒ **create_task** (`Function`)
-    - 📝 Create and start a new task using TaskManager. Non-blocking.
-    - 🔗 CALLS -> `task_manager.create_task`
-- 🧩 **FrontendComponentShot** (`Component`) `[CRITICAL]`
-  - 📝 Action button to spawn a new task with full UX feedback cycle.
-  - 🏗️ Layer: UI (Presentation)
-  - 🔒 Invariant: Must prevent double-submission while loading.
-  - 📥 Props: plugin_id: any, params: any
-  - ⬅️ READS_FROM `lib`
-  - ⬅️ READS_FROM `t`
-  - ƒ **spawnTask** (`Function`)
-    - 📝 Execute task creation request and emit user feedback.
 - 📦 **DashboardTypes** (`Module`) `[TRIVIAL]`
   - 📝 TypeScript interfaces for Dashboard entities
   - 🏗️ Layer: Domain
@@ -191,6 +154,18 @@
   - 🏗️ Layer: Infra
   - ƒ **debounce** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 🗄️ **assistantChat** (`Store`)
+  - 📝 Control assistant chat panel visibility and active conversation binding.
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: conversationId persists while panel toggles unless explicitly reset.
+  - ƒ **toggleAssistantChat** (`Function`)
+    - 📝 Toggle assistant panel visibility.
+  - ƒ **openAssistantChat** (`Function`)
+    - 📝 Open assistant panel.
+  - ƒ **closeAssistantChat** (`Function`)
+    - 📝 Close assistant panel.
+  - ƒ **setAssistantConversationId** (`Function`)
+    - 📝 Bind current conversation id in UI state.
 - 🗄️ **taskDrawer** (`Store`) `[CRITICAL]`
   - 📝 Manage Task Drawer visibility and resource-to-task mapping
   - 🏗️ Layer: UI
@@ -253,6 +228,13 @@
   - 📝 Unit tests for task drawer store
   - 🏗️ Layer: UI
   - 🔒 Invariant: Store state transitions remain deterministic for open/close and task-status mapping.
+- 📦 **frontend.src.lib.stores.__tests__.assistantChat** (`Module`)
+  - 📝 Validate assistant chat store visibility and conversation binding transitions.
+  - 🏗️ Layer: UI Tests
+  - 🔒 Invariant: Each test starts from default closed state.
+  - 🔗 DEPENDS_ON -> `assistantChatStore`
+  - ƒ **assistantChatStore_tests** (`Function`)
+    - 📝 Group store unit scenarios for assistant panel behavior.
 - 📦 **navigation** (`Mock`)
   - 📝 Mock for $app/navigation in tests
 - 📦 **stores** (`Mock`)
@@ -272,6 +254,21 @@
     - 📝 Fetch unified report list using existing request wrapper.
   - ƒ **getReportDetail** (`Function`)
     - 📝 Fetch one report detail by report_id.
+- 📦 **frontend.src.lib.api.assistant** (`Module`)
+  - 📝 API client wrapper for assistant chat, confirmation actions, and history retrieval.
+  - 🏗️ Layer: Infra-API
+  - 🔒 Invariant: All assistant requests must use requestApi wrapper (no native fetch).
+  - 🔗 DEPENDS_ON -> `frontend.src.lib.api.api_module`
+  - ƒ **sendAssistantMessage** (`Function`)
+    - 📝 Send a user message to assistant orchestrator endpoint.
+  - ƒ **confirmAssistantOperation** (`Function`)
+    - 📝 Confirm a pending risky assistant operation.
+  - ƒ **cancelAssistantOperation** (`Function`)
+    - 📝 Cancel a pending risky assistant operation.
+  - ƒ **getAssistantHistory** (`Function`)
+    - 📝 Retrieve paginated assistant conversation history.
+  - ƒ **getAssistantConversations** (`Function`)
+    - 📝 Retrieve paginated conversation list for assistant sidebar/history switcher.
 - 🧩 **Select** (`Component`) `[TRIVIAL]`
   - 📝 Standardized dropdown selection component.
   - 🏗️ Layer: Atom
@@ -322,6 +319,60 @@
     - 📝 Derived store providing the translation dictionary.
   - ƒ **_** (`Function`)
     - 📝 Get translation by key path.
+- 🧩 **AssistantChatPanel** (`Component`) `[CRITICAL]`
+  - 📝 Slide-out assistant chat panel for natural language command execution and task tracking.
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Risky operations are executed only through explicit confirm action.
+  - ⬅️ READS_FROM `app`
+  - ⬅️ READS_FROM `lib`
+  - ⬅️ READS_FROM `assistantChatStore`
+  - ƒ **loadHistory** (`Function`)
+    - 📝 Load current conversation history when panel becomes visible.
+  - ƒ **loadConversations** (`Function`)
+    - 📝 Load paginated conversation summaries for quick switching UI.
+  - ƒ **loadOlderMessages** (`Function`)
+    - 📝 Lazy-load older messages for active conversation when user scrolls to top.
+  - ƒ **appendLocalUserMessage** (`Function`)
+    - 📝 Add optimistic local user message before backend response.
+  - ƒ **appendAssistantResponse** (`Function`)
+    - 📝 Normalize and append assistant response payload to chat list.
+  - ƒ **handleSend** (`Function`)
+    - 📝 Submit user command to assistant orchestration API.
+  - ƒ **selectConversation** (`Function`)
+    - 📝 Switch active chat context to selected conversation item.
+  - ƒ **startNewConversation** (`Function`)
+    - 📝 Create local empty chat context that will be persisted on first message.
+  - ƒ **handleAction** (`Function`)
+    - 📝 Execute assistant action button behavior (open task/reports, confirm, cancel).
+  - ƒ **handleKeydown** (`Function`)
+    - 📝 Submit command by Enter while preserving multiline input with Shift+Enter.
+  - ƒ **stateClass** (`Function`)
+    - 📝 Map assistant state to visual badge style class.
+  - ƒ **handleHistoryScroll** (`Function`)
+    - 📝 Trigger lazy history fetch when user scroll reaches top boundary.
+- 📦 **AssistantChatPanel** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/components/assistant/AssistantChatPanel.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **buildConversationTitle** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **setConversationFilter** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **formatConversationTime** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 📦 **frontend.src.lib.components.assistant.__tests__.assistant_confirmation_integration** (`Module`)
+  - 📝 Validate confirm/cancel UX contract bindings in assistant chat panel source.
+  - 🏗️ Layer: UI Tests
+  - 🔒 Invariant: Confirm/cancel action handling must remain explicit and confirmation-id bound.
+  - ƒ **assistant_confirmation_contract_tests** (`Function`)
+    - 📝 Assert that confirmation UX flow and API bindings are preserved in chat panel.
+- 📦 **frontend.src.lib.components.assistant.__tests__.assistant_chat_integration** (`Module`)
+  - 📝 Contract-level integration checks for assistant chat panel implementation and localization wiring.
+  - 🏗️ Layer: UI Tests
+  - 🔒 Invariant: Critical assistant UX states and action hooks remain present in component source.
+  - ƒ **readJson** (`Function`)
+    - 📝 Read and parse JSON fixture file from disk.
+  - ƒ **assistant_chat_contract_tests** (`Function`)
+    - 📝 Validate assistant chat component contract and locale integration without DOM runtime dependency.
 - 🧩 **ReportCard** (`Component`) `[CRITICAL]`
   - 📝 Render one report with explicit textual type label and profile-driven visual variant.
   - 🏗️ Layer: UI
@@ -448,6 +499,8 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **handleActivityClick** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **handleAssistantClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **handleSearchFocus** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **handleSearchBlur** (`Function`) `[TRIVIAL]`
@@ -670,11 +723,19 @@
 - 🧩 **LLMSettingsPage** (`Component`)
   - 📝 Admin settings page for LLM provider configuration.
   - 🏗️ Layer: UI
+  - ⬅️ READS_FROM `t`
+  - ➡️ WRITES_TO `t`
 - 📦 **+page** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/routes/admin/settings/llm/+page.svelte
   - 🏗️ Layer: Unknown
+  - ƒ **isMultimodalModel** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getProviderById** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **fetchProviders** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **saveSettings** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 🧩 **MigrationDashboard** (`Component`)
   - 📝 Main dashboard for configuring and starting migrations.
   - 🏗️ Layer: Page
@@ -704,6 +765,8 @@
   - 🏗️ Layer: Page
   - 🔒 Invariant: Mappings are saved to the backend for persistence.
   - ⬅️ READS_FROM `lib`
+  - ➡️ WRITES_TO `t`
+  - ⬅️ READS_FROM `t`
   - ƒ **fetchEnvironments** (`Function`)
     - 📝 Fetches the list of environments.
   - ƒ **fetchDatabases** (`Function`)
@@ -742,6 +805,14 @@
   - 🏗️ Layer: Unknown
   - ƒ **loadSettings** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **normalizeLlmSettings** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **isMultimodalModel** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getProviderById** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **isDashboardValidationBindingValid** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **handleTabChange** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **getTabClass** (`Function`) `[TRIVIAL]`
@@ -782,6 +853,7 @@
   - 📝 Dashboard management page for Git integration.
   - 🏗️ Layer: Page
   - ⬅️ READS_FROM `lib`
+  - ➡️ WRITES_TO `t`
   - ƒ **fetchEnvironments** (`Function`)
     - 📝 Fetches the list of deployment environments from the API.
   - ƒ **fetchDashboards** (`Function`)
@@ -930,6 +1002,7 @@
   - 🔒 Invariant: Modal blocks migration progress until resolved or cancelled.
   - ⚡ Events: cancel, resolve
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ƒ **resolve** (`Function`)
     - 📝 Dispatches the resolution event with the selected mapping.
   - ƒ **cancel** (`Function`)
@@ -940,8 +1013,8 @@
   - 🔒 Invariant: Selected IDs must be a subset of available dashboards.
   - ⚡ Events: selectionChanged
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ➡️ WRITES_TO `derived`
-  - ➡️ WRITES_TO `t`
   - ƒ **handleValidate** (`Function`)
     - 📝 Triggers dashboard validation task.
   - ƒ **handleSort** (`Function`)
@@ -1037,6 +1110,7 @@
   - 🔒 Invariant: Source and target environments must be selectable from the list of configured environments.
   - ⚡ Events: change
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `t`
   - ƒ **handleSelect** (`Function`)
     - 📝 Dispatches the selection change event.
 - 🧩 **ProtectedRoute** (`Component`) `[TRIVIAL]`
@@ -1111,8 +1185,8 @@
   - 🏗️ Layer: UI
   - ⚡ Events: uploaded
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ⬅️ READS_FROM `t`
-  - ➡️ WRITES_TO `t`
   - ƒ **handleUpload** (`Function`)
     - 📝 Handles the file upload process.
   - ƒ **handleDrop** (`Function`)
@@ -1121,8 +1195,8 @@
   - 📝 UI component for creating a new database connection configuration.
   - 🏗️ Layer: UI
   - ⚡ Events: success
-  - ➡️ WRITES_TO `t`
   - ⬅️ READS_FROM `t`
+  - ➡️ WRITES_TO `t`
   - ƒ **handleSubmit** (`Function`)
     - 📝 Submits the connection form to the backend.
   - ƒ **resetForm** (`Function`)
@@ -1130,8 +1204,8 @@
 - 🧩 **ConnectionList** (`Component`)
   - 📝 UI component for listing and deleting saved database connection configurations.
   - 🏗️ Layer: UI
-  - ➡️ WRITES_TO `t`
   - ⬅️ READS_FROM `t`
+  - ➡️ WRITES_TO `t`
   - ƒ **fetchConnections** (`Function`)
     - 📝 Fetches the list of connections from the backend.
   - ƒ **handleDelete** (`Function`)
@@ -1155,6 +1229,8 @@
 - 🧩 **DebugTool** (`Component`)
   - 📝 UI component for system diagnostics and debugging API responses.
   - 🏗️ Layer: UI
+  - ⬅️ READS_FROM `t`
+  - ➡️ WRITES_TO `t`
   - ƒ **fetchEnvironments** (`Function`)
     - 📝 Fetches available environments.
   - ƒ **handleRunDebug** (`Function`)
@@ -1165,8 +1241,8 @@
   - 📝 Displays the commit history for a specific dashboard.
   - 🏗️ Layer: Component
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ⬅️ READS_FROM `t`
-  - ➡️ WRITES_TO `t`
   - ƒ **onMount** (`Function`)
     - 📝 Load history when component is mounted.
   - ƒ **loadHistory** (`Function`)
@@ -1177,6 +1253,7 @@
   - 🔒 Invariant: Cannot deploy without a selected environment.
   - ⚡ Events: deploy
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ⬅️ READS_FROM `effect`
   - 📦 **loadStatus** (`Watcher`)
   - ƒ **loadEnvironments** (`Function`)
@@ -1189,6 +1266,7 @@
   - 🔒 Invariant: User must resolve all conflicts before saving.
   - ⚡ Events: resolve
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ƒ **resolve** (`Function`)
     - 📝 Set resolution strategy for a file.
   - ƒ **handleSave** (`Function`)
@@ -1198,7 +1276,8 @@
   - 🏗️ Layer: Component
   - ⚡ Events: commit
   - ➡️ WRITES_TO `props`
-  - ⬅️ READS_FROM `effect`
+  - ➡️ WRITES_TO `state`
+  - ⬅️ READS_FROM `t`
   - ƒ **handleGenerateMessage** (`Function`)
     - 📝 Generates a commit message using LLM.
   - ƒ **loadStatus** (`Function`)
@@ -1210,6 +1289,7 @@
   - 🏗️ Layer: Component
   - ⚡ Events: change
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ⬅️ READS_FROM `t`
   - ƒ **onMount** (`Function`)
     - 📝 Load branches when component is mounted.
@@ -1225,7 +1305,7 @@
   - 📝 Центральный компонент для управления Git-операциями конкретного дашборда.
   - 🏗️ Layer: Component
   - ➡️ WRITES_TO `props`
-  - ➡️ WRITES_TO `t`
+  - ➡️ WRITES_TO `state`
   - ⬅️ READS_FROM `t`
   - ƒ **checkStatus** (`Function`)
     - 📝 Проверяет, инициализирован ли репозиторий для данного дашборда.
@@ -1241,8 +1321,8 @@
   - 📝 UI component for previewing generated dataset documentation before saving.
   - 🏗️ Layer: UI
   - ➡️ WRITES_TO `props`
-  - ➡️ WRITES_TO `t`
-  - ⬅️ READS_FROM `t`
+  - ➡️ WRITES_TO `derived`
+  - ➡️ WRITES_TO `state`
 - 📦 **DocPreview** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/components/llm/DocPreview.svelte
   - 🏗️ Layer: Unknown
@@ -1251,12 +1331,14 @@
 - 🧩 **ProviderConfig** (`Component`)
   - 📝 UI form for managing LLM provider configurations.
   - 🏗️ Layer: UI
-  - ➡️ WRITES_TO `props`
+  - 📥 Props: providers: any, onSave: any
   - ➡️ WRITES_TO `t`
   - ⬅️ READS_FROM `t`
 - 📦 **ProviderConfig** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/components/llm/ProviderConfig.svelte
   - 🏗️ Layer: Unknown
+  - ƒ **isMultimodalModel** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **resetForm** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **handleEdit** (`Function`) `[TRIVIAL]`
@@ -1272,6 +1354,12 @@
   - 🏗️ Layer: Unknown
   - ƒ **getStatusColor** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 📦 **frontend.src.components.llm.__tests__.provider_config_integration** (`Module`)
+  - 📝 Protect edit-button interaction contract in LLM provider settings UI.
+  - 🏗️ Layer: UI Tests
+  - 🔒 Invariant: Edit action keeps explicit click handler and opens normalized edit form.
+  - ƒ **provider_config_edit_contract_tests** (`Function`)
+    - 📝 Validate edit button handler wiring and normalized edit form state mapping.
 - 📦 **test_auth_debug** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for backend/test_auth_debug.py
   - 🏗️ Layer: Unknown
@@ -1423,6 +1511,14 @@
       - 📝 Получает полный список дашбордов, автоматически обрабатывая пагинацию.
     - ƒ **get_dashboards_summary** (`Function`)
       - 📝 Fetches dashboard metadata optimized for the grid.
+    - ƒ **get_dashboard** (`Function`)
+      - 📝 Fetches a single dashboard by ID.
+    - ƒ **get_chart** (`Function`)
+      - 📝 Fetches a single chart by ID.
+    - ƒ **get_dashboard_detail** (`Function`)
+      - 📝 Fetches detailed dashboard information including related charts and datasets.
+    - ƒ **_extract_chart_ids_from_layout** (`Function`)
+      - 📝 Traverses dashboard layout metadata and extracts chart IDs from common keys.
     - ƒ **export_dashboard** (`Function`)
       - 📝 Экспортирует дашборд в виде ZIP-архива.
     - ƒ **import_dashboard** (`Function`)
@@ -1465,6 +1561,12 @@
       - 📝 Iterates through all pages to collect all data items.
     - ƒ **_validate_import_file** (`Function`)
       - 📝 Validates that the file to be imported is a valid ZIP with metadata.yaml.
+  - ƒ **extract_dataset_id_from_form_data** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **walk** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **as_bool** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **ConfigManagerModule** (`Module`)
   - 📝 Manages application configuration persisted in database with one-time migration from JSON.
   - 🏗️ Layer: Core
@@ -1541,6 +1643,8 @@
   - 🏗️ Layer: Core
   - 🔒 Invariant: A single engine instance is used for the entire application.
   - 🔗 DEPENDS_ON -> `sqlalchemy`
+  - 🔗 DEPENDS_ON -> `backend.src.models.mapping`
+  - 🔗 DEPENDS_ON -> `backend.src.core.auth.config`
   - 📦 **BASE_DIR** (`Variable`)
     - 📝 Base directory for the backend.
   - 📦 **DATABASE_URL** (`Constant`)
@@ -1555,11 +1659,11 @@
     - 📝 SQLAlchemy engine for tasks database.
   - 📦 **auth_engine** (`Variable`)
     - 📝 SQLAlchemy engine for authentication database.
-  - ℂ **SessionLocal** (`Class`)
+  - ℂ **SessionLocal** (`Class`) `[TRIVIAL]`
     - 📝 A session factory for the main mappings database.
-  - ℂ **TasksSessionLocal** (`Class`)
+  - ℂ **TasksSessionLocal** (`Class`) `[TRIVIAL]`
     - 📝 A session factory for the tasks execution database.
-  - ℂ **AuthSessionLocal** (`Class`)
+  - ℂ **AuthSessionLocal** (`Class`) `[TRIVIAL]`
     - 📝 A session factory for the authentication database.
   - ƒ **init_db** (`Function`)
     - 📝 Initializes the database by creating all tables.
@@ -2320,6 +2424,86 @@
     - 📝 Schema for dashboard deployment requests.
   - ℂ **RepoInitRequest** (`Class`)
     - 📝 Schema for repository initialization requests.
+- 📦 **backend.src.api.routes.assistant** (`Module`)
+  - 📝 API routes for LLM assistant command parsing and safe execution orchestration.
+  - 🏗️ Layer: API
+  - 🔒 Invariant: Risky operations are never executed without valid confirmation token.
+  - 🔗 DEPENDS_ON -> `backend.src.core.task_manager`
+  - 🔗 DEPENDS_ON -> `backend.src.models.assistant`
+  - ℂ **AssistantMessageRequest** (`Class`) `[TRIVIAL]`
+    - 📝 Input payload for assistant message endpoint.
+  - ℂ **AssistantAction** (`Class`) `[TRIVIAL]`
+    - 📝 UI action descriptor returned with assistant responses.
+  - ℂ **AssistantMessageResponse** (`Class`)
+    - 📝 Output payload contract for assistant interaction endpoints.
+  - ℂ **ConfirmationRecord** (`Class`)
+    - 📝 In-memory confirmation token model for risky operation dispatch.
+  - ƒ **_append_history** (`Function`)
+    - 📝 Append conversation message to in-memory history buffer.
+  - ƒ **_persist_message** (`Function`)
+    - 📝 Persist assistant/user message record to database.
+  - ƒ **_audit** (`Function`)
+    - 📝 Append in-memory audit record for assistant decision trace.
+  - ƒ **_persist_audit** (`Function`)
+    - 📝 Persist structured assistant audit payload in database.
+  - ƒ **_persist_confirmation** (`Function`)
+    - 📝 Persist confirmation token record to database.
+  - ƒ **_update_confirmation_state** (`Function`)
+    - 📝 Update persistent confirmation token lifecycle state.
+  - ƒ **_load_confirmation_from_db** (`Function`)
+    - 📝 Load confirmation token from database into in-memory model.
+  - ƒ **_ensure_conversation** (`Function`)
+    - 📝 Resolve active conversation id in memory or create a new one.
+  - ƒ **_resolve_or_create_conversation** (`Function`)
+    - 📝 Resolve active conversation using explicit id, memory cache, or persisted history.
+  - ƒ **_cleanup_history_ttl** (`Function`)
+    - 📝 Enforce assistant message retention window by deleting expired rows and in-memory records.
+  - ƒ **_is_conversation_archived** (`Function`)
+    - 📝 Determine archived state for a conversation based on last update timestamp.
+  - ƒ **_coerce_query_bool** (`Function`)
+    - 📝 Normalize bool-like query values for compatibility in direct handler invocations/tests.
+  - ƒ **_extract_id** (`Function`)
+    - 📝 Extract first regex match group from text by ordered pattern list.
+  - ƒ **_resolve_env_id** (`Function`)
+    - 📝 Resolve environment identifier/name token to canonical environment id.
+  - ƒ **_is_production_env** (`Function`)
+    - 📝 Determine whether environment token resolves to production-like target.
+  - ƒ **_resolve_provider_id** (`Function`)
+    - 📝 Resolve provider token to provider id with active/default fallback.
+  - ƒ **_get_default_environment_id** (`Function`)
+    - 📝 Resolve default environment id from settings or first configured environment.
+  - ƒ **_resolve_dashboard_id_by_ref** (`Function`)
+    - 📝 Resolve dashboard id by title or slug reference in selected environment.
+  - ƒ **_parse_command** (`Function`)
+    - 📝 Deterministically parse RU/EN command text into intent payload.
+  - ƒ **_check_any_permission** (`Function`)
+    - 📝 Validate user against alternative permission checks (logical OR).
+  - ƒ **_has_any_permission** (`Function`)
+    - 📝 Check whether user has at least one permission tuple from the provided list.
+  - ƒ **_build_tool_catalog** (`Function`)
+    - 📝 Build current-user tool catalog for LLM planner with operation contracts and defaults.
+  - ƒ **_coerce_intent_entities** (`Function`)
+    - 📝 Normalize intent entity value types from LLM output to route-compatible values.
+  - ƒ **_clarification_text_for_intent** (`Function`)
+    - 📝 Convert technical missing-parameter errors into user-facing clarification prompts.
+  - ƒ **_plan_intent_with_llm** (`Function`)
+    - 📝 Use active LLM provider to select best tool/operation from dynamic catalog.
+  - ƒ **_authorize_intent** (`Function`)
+    - 📝 Validate user permissions for parsed intent before confirmation/dispatch.
+  - ƒ **_dispatch_intent** (`Function`)
+    - 📝 Execute parsed assistant intent via existing task/plugin/git services.
+  - ƒ **send_message** (`Function`)
+    - 📝 Parse assistant command, enforce safety gates, and dispatch executable intent.
+  - ƒ **confirm_operation** (`Function`)
+    - 📝 Execute previously requested risky operation after explicit user confirmation.
+  - ƒ **cancel_operation** (`Function`)
+    - 📝 Cancel pending risky operation and mark confirmation token as cancelled.
+  - ƒ **list_conversations** (`Function`)
+    - 📝 Return paginated conversation list for current user with archived flag and last message preview.
+  - ƒ **get_history** (`Function`)
+    - 📝 Retrieve paginated assistant conversation history for current user.
+  - ƒ **get_assistant_audit** (`Function`)
+    - 📝 Return assistant audit decisions for current user from persistent and in-memory stores.
 - 📦 **storage_routes** (`Module`)
   - 📝 API endpoints for file storage management (backups and repositories).
   - 🏗️ Layer: API
@@ -2349,11 +2533,13 @@
     - 📝 Return paginated unified reports list.
   - ƒ **get_report_detail** (`Function`)
     - 📝 Return one normalized report detail with diagnostics and next actions.
-- 📦 **__init__** (`Module`) `[TRIVIAL]`
-  - 📝 Auto-generated module for backend/src/api/routes/__init__.py
-  - 🏗️ Layer: Unknown
+- 📦 **backend.src.api.routes.__init__** (`Module`)
+  - 📝 Provide lazy route module loading to avoid heavyweight imports during tests.
+  - 🏗️ Layer: API
+  - 🔒 Invariant: Only names listed in __all__ are importable via __getattr__.
+  - 🔗 DEPENDS_ON -> `importlib`
   - ƒ **__getattr__** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
+    - 📝 Lazily import route module by attribute name.
 - 📦 **TasksRouter** (`Module`)
   - 📝 Defines the FastAPI router for task-related endpoints, allowing clients to create, list, and get the status of tasks.
   - 🏗️ Layer: UI (API)
@@ -2386,9 +2572,15 @@
   - 📦 **LastTask** (`DataClass`)
   - 📦 **DashboardItem** (`DataClass`)
   - 📦 **DashboardsResponse** (`DataClass`)
+  - 📦 **DashboardChartItem** (`DataClass`)
+  - 📦 **DashboardDatasetItem** (`DataClass`)
+  - 📦 **DashboardDetailResponse** (`DataClass`)
   - ƒ **get_dashboards** (`Function`)
     - 📝 Fetch list of dashboards from a specific environment with Git status and last task status
     - 🔗 CALLS -> `ResourceService.get_dashboards_with_status`
+  - ƒ **get_dashboard_detail** (`Function`)
+    - 📝 Fetch detailed dashboard info with related charts and datasets
+    - 🔗 CALLS -> `SupersetClient.get_dashboard_detail`
   - 📦 **MigrateRequest** (`DataClass`)
   - 📦 **TaskResponse** (`DataClass`)
   - ƒ **migrate_dashboards** (`Function`)
@@ -2412,6 +2604,8 @@
   - ƒ **test_get_dashboards_with_search** (`Function`)
   - ƒ **test_get_dashboards_env_not_found** (`Function`)
   - ƒ **test_get_dashboards_invalid_pagination** (`Function`)
+  - ƒ **test_get_dashboard_detail_success** (`Function`)
+  - ƒ **test_get_dashboard_detail_env_not_found** (`Function`)
   - ƒ **test_migrate_dashboards_success** (`Function`)
   - ƒ **test_migrate_dashboards_no_ids** (`Function`)
   - ƒ **test_backup_dashboards_success** (`Function`)
@@ -2483,6 +2677,160 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **test_get_report_detail_not_found** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 📦 **backend.src.api.routes.__tests__.test_assistant_authz** (`Module`)
+  - 📝 Verify assistant confirmation ownership, expiration, and deny behavior for restricted users.
+  - 🏗️ Layer: UI (API Tests)
+  - 🔒 Invariant: Security-sensitive flows fail closed for unauthorized actors.
+  - 🔗 DEPENDS_ON -> `backend.src.api.routes.assistant`
+  - ƒ **_run_async** (`Function`) `[TRIVIAL]`
+    - 📝 Execute async endpoint handler in synchronous test context.
+  - ℂ **_FakeTask** (`Class`) `[TRIVIAL]`
+    - 📝 Lightweight task model used for assistant authz tests.
+  - ℂ **_FakeTaskManager** (`Class`) `[TRIVIAL]`
+    - 📝 Minimal task manager for deterministic operation creation and lookup.
+  - ℂ **_FakeConfigManager** (`Class`) `[TRIVIAL]`
+    - 📝 Provide deterministic environment aliases required by intent parsing.
+  - ƒ **_admin_user** (`Function`) `[TRIVIAL]`
+    - 📝 Build admin principal fixture.
+  - ƒ **_other_admin_user** (`Function`) `[TRIVIAL]`
+    - 📝 Build second admin principal fixture for ownership tests.
+  - ƒ **_limited_user** (`Function`) `[TRIVIAL]`
+    - 📝 Build limited principal without required assistant execution privileges.
+  - ℂ **_FakeQuery** (`Class`) `[TRIVIAL]`
+    - 📝 Minimal chainable query object for fake DB interactions.
+  - ℂ **_FakeDb** (`Class`) `[TRIVIAL]`
+    - 📝 In-memory session substitute for assistant route persistence calls.
+  - ƒ **_clear_assistant_state** (`Function`) `[TRIVIAL]`
+    - 📝 Reset assistant process-local state between test cases.
+  - ƒ **test_confirmation_owner_mismatch_returns_403** (`Function`)
+    - 📝 Confirm endpoint should reject requests from user that does not own the confirmation token.
+  - ƒ **test_expired_confirmation_cannot_be_confirmed** (`Function`)
+    - 📝 Expired confirmation token should be rejected and not create task.
+  - ƒ **test_limited_user_cannot_launch_restricted_operation** (`Function`)
+    - 📝 Limited user should receive denied state for privileged operation.
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **create_task** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **get_task** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **get_tasks** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **get_environments** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **filter** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **order_by** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **first** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **all** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **limit** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **offset** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **count** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **add** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **merge** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **query** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **commit** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **rollback** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 📦 **backend.src.api.routes.__tests__.test_assistant_api** (`Module`)
+  - 📝 Validate assistant API endpoint logic via direct async handler invocation.
+  - 🏗️ Layer: UI (API Tests)
+  - 🔒 Invariant: Every test clears assistant in-memory state before execution.
+  - 🔗 DEPENDS_ON -> `backend.src.api.routes.assistant`
+  - ƒ **_run_async** (`Function`) `[TRIVIAL]`
+    - 📝 Execute async endpoint handler in synchronous test context.
+  - ℂ **_FakeTask** (`Class`) `[TRIVIAL]`
+    - 📝 Lightweight task stub used by assistant API tests.
+  - ℂ **_FakeTaskManager** (`Class`) `[TRIVIAL]`
+    - 📝 Minimal async-compatible TaskManager fixture for deterministic test flows.
+  - ℂ **_FakeConfigManager** (`Class`) `[TRIVIAL]`
+    - 📝 Environment config fixture with dev/prod aliases for parser tests.
+  - ƒ **_admin_user** (`Function`) `[TRIVIAL]`
+    - 📝 Build admin principal fixture.
+  - ƒ **_limited_user** (`Function`) `[TRIVIAL]`
+    - 📝 Build non-admin principal fixture.
+  - ℂ **_FakeQuery** (`Class`) `[TRIVIAL]`
+    - 📝 Minimal chainable query object for fake SQLAlchemy-like DB behavior in tests.
+  - ℂ **_FakeDb** (`Class`) `[TRIVIAL]`
+    - 📝 In-memory fake database implementing subset of Session interface used by assistant routes.
+  - ƒ **_clear_assistant_state** (`Function`) `[TRIVIAL]`
+    - 📝 Reset in-memory assistant registries for isolation between tests.
+  - ƒ **test_unknown_command_returns_needs_clarification** (`Function`)
+    - 📝 Unknown command should return clarification state and unknown intent.
+  - ƒ **test_capabilities_question_returns_successful_help** (`Function`)
+    - 📝 Capability query should return deterministic help response, not clarification.
+  - ƒ **test_non_admin_command_returns_denied** (`Function`)
+    - 📝 Non-admin user must receive denied state for privileged command.
+  - ƒ **test_migration_to_prod_requires_confirmation_and_can_be_confirmed** (`Function`)
+    - 📝 Migration to prod must require confirmation and then start task after explicit confirm.
+  - ƒ **test_status_query_returns_task_status** (`Function`)
+    - 📝 Task status command must surface current status text for existing task id.
+  - ƒ **test_status_query_without_task_id_returns_latest_user_task** (`Function`)
+    - 📝 Status command without explicit task_id should resolve to latest task for current user.
+  - ƒ **test_llm_validation_missing_dashboard_returns_needs_clarification** (`Function`)
+    - 📝 LLM validation command without resolvable dashboard id must request clarification instead of generic failure.
+  - ƒ **test_list_conversations_groups_by_conversation_and_marks_archived** (`Function`)
+    - 📝 Conversations endpoint must group messages and compute archived marker by inactivity threshold.
+  - ƒ **test_history_from_latest_returns_recent_page_first** (`Function`)
+    - 📝 History endpoint from_latest mode must return newest page while preserving chronological order in chunk.
+  - ƒ **test_list_conversations_archived_only_filters_active** (`Function`)
+    - 📝 archived_only mode must return only archived conversations.
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **create_task** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **get_task** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **get_tasks** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **get_environments** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **filter** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **order_by** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **first** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **all** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **count** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **offset** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **limit** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **add** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **merge** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **query** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **commit** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **rollback** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **backend.src.models.config** (`Module`)
   - 📝 Defines database schema for persisted application configuration.
   - 🏗️ Layer: Domain
@@ -2565,6 +2913,17 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **_validate_time_range** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 📦 **backend.src.models.assistant** (`Module`)
+  - 📝 SQLAlchemy models for assistant audit trail and confirmation tokens.
+  - 🏗️ Layer: Domain
+  - 🔒 Invariant: Assistant records preserve immutable ids and creation timestamps.
+  - 🔗 DEPENDS_ON -> `backend.src.models.mapping`
+  - ℂ **AssistantAuditRecord** (`Class`)
+    - 📝 Store audit decisions and outcomes produced by assistant command handling.
+  - ℂ **AssistantMessageRecord** (`Class`)
+    - 📝 Persist chat history entries for assistant conversations.
+  - ℂ **AssistantConfirmationRecord** (`Class`)
+    - 📝 Persist risky operation confirmation tokens with lifecycle state.
 - 📦 **backend.src.models.storage** (`Module`) `[TRIVIAL]`
   - 📝 Data models for the storage system.
   - 🏗️ Layer: Domain
@@ -2636,6 +2995,25 @@
       - 📝 Extract resource name from task params
     - ƒ **_extract_resource_type_from_task** (`Function`)
       - 📝 Extract resource type from task params
+- 📦 **backend.src.services.llm_prompt_templates** (`Module`)
+  - 📝 Provide default LLM prompt templates and normalization helpers for runtime usage.
+  - 🏗️ Layer: Domain
+  - 🔒 Invariant: All required prompt template keys are always present after normalization.
+  - 🔗 DEPENDS_ON -> `backend.src.core.config_manager`
+  - 📦 **DEFAULT_LLM_PROMPTS** (`Constant`)
+    - 📝 Default prompt templates used by documentation, dashboard validation, and git commit generation.
+  - 📦 **DEFAULT_LLM_PROVIDER_BINDINGS** (`Constant`)
+    - 📝 Default provider binding per task domain.
+  - 📦 **DEFAULT_LLM_ASSISTANT_SETTINGS** (`Constant`)
+    - 📝 Default planner settings for assistant chat intent model/provider resolution.
+  - ƒ **normalize_llm_settings** (`Function`)
+    - 📝 Ensure llm settings contain stable schema with prompts section and default templates.
+  - ƒ **is_multimodal_model** (`Function`)
+    - 📝 Heuristically determine whether model supports image input required for dashboard validation.
+  - ƒ **resolve_bound_provider_id** (`Function`)
+    - 📝 Resolve provider id configured for a task binding with fallback to default provider.
+  - ƒ **render_prompt** (`Function`)
+    - 📝 Render prompt template using deterministic placeholder replacement with graceful fallback.
 - 📦 **backend.src.services.llm_provider** (`Module`)
   - 📝 Service for managing LLM provider configurations with encrypted API keys.
   - 🏗️ Layer: Domain
@@ -2741,6 +3119,23 @@
       - 📝 Helper to get an initialized SupersetClient for an environment.
     - ƒ **get_suggestions** (`Function`)
       - 📝 Fetches databases from both environments and returns fuzzy matching suggestions.
+- 📦 **backend.src.services.__tests__.test_llm_prompt_templates** (`Module`)
+  - 📝 Validate normalization and rendering behavior for configurable LLM prompt templates.
+  - 🏗️ Layer: Domain Tests
+  - 🔒 Invariant: All required prompt keys remain available after normalization.
+  - 🔗 DEPENDS_ON -> `backend.src.services.llm_prompt_templates`
+  - ƒ **test_normalize_llm_settings_adds_default_prompts** (`Function`)
+    - 📝 Ensure legacy/partial llm settings are expanded with all prompt defaults.
+  - ƒ **test_normalize_llm_settings_keeps_custom_prompt_values** (`Function`)
+    - 📝 Ensure user-customized prompt values are preserved during normalization.
+  - ƒ **test_render_prompt_replaces_known_placeholders** (`Function`)
+    - 📝 Ensure template placeholders are deterministically replaced.
+  - ƒ **test_is_multimodal_model_detects_known_vision_models** (`Function`)
+    - 📝 Ensure multimodal model detection recognizes common vision-capable model names.
+  - ƒ **test_resolve_bound_provider_id_prefers_binding_then_default** (`Function`)
+    - 📝 Verify provider binding resolution priority.
+  - ƒ **test_normalize_llm_settings_keeps_assistant_planner_settings** (`Function`)
+    - 📝 Ensure assistant planner provider/model fields are preserved and normalized.
 - 📦 **backend.src.services.__tests__.test_resource_service** (`Module`)
   - 📝 Unit tests for ResourceService
   - 🏗️ Layer: Service

generate_semantic_map.py

@@ -82,6 +82,12 @@ IGNORE_DIRS = {
 IGNORE_FILES = {
     "package-lock.json", "poetry.lock", "yarn.lock"
 }
+IGNORE_PATH_PREFIXES = {
+    ".ai/shots/"
+}
+IGNORE_EXACT_PATHS = {
+    ".ai/shots"
+}
 OUTPUT_JSON = "semantics/semantic_map.json"
 OUTPUT_COMPRESSED_MD = ".ai/PROJECT_MAP.md"
 OUTPUT_MODULE_MAP_MD = ".ai/MODULE_MAP.md"
@@ -708,6 +714,13 @@ class SemanticMapGenerator:
         with belief_scope("_is_ignored"):
             rel_path = rel_path.replace(os.sep, '/')
 
+            if rel_path in IGNORE_EXACT_PATHS:
+                return True
+
+            for prefix in IGNORE_PATH_PREFIXES:
+                if rel_path.startswith(prefix):
+                    return True
+
             parts = rel_path.split('/')
             for part in parts:
                 if part in IGNORE_DIRS:

specs/020-task-reports-design/tasks.md

@@ -127,6 +127,7 @@
 - [x] T040 Remove deprecated tasks page route and redirect UI navigation entry points to reports (`frontend/src/routes/tasks/+page.svelte`, `frontend/src/lib/components/layout/TaskDrawer.svelte`, `frontend/src/components/Navbar.svelte`)
 - [x] T041 Fix reports list sorting/filtering for mixed offset-naive and offset-aware datetimes to prevent `GET /api/reports` 500 during active migration (`backend/src/services/reports/report_service.py`, `backend/src/api/routes/__tests__/test_reports_api.py`)
 - [x] T042 Add frontend submit-guard for dashboard migration/backup modal actions to prevent duplicate task creation on repeated clicks (`frontend/src/routes/dashboards/+page.svelte`)
+- [x] T043 Update semantic map generator to ignore few-shot examples under `.ai/shots/` (`generate_semantic_map.py`)
 
 ---