busya/ss-tools
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

generate semantic clean up

Browse Source
This commit is contained in:
busya
2026-02-24 12:51:57 +03:00
parent 7df7b4f98c
commit 286167b1d5
5 changed files with 7014 additions and 1250 deletions
Download Patch File Download Diff File Expand all files Collapse all files

254
.ai/MODULE_MAP.md
View File

@@ -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

503
.ai/PROJECT_MAP.md
View File

@@ -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