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