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

feat: Introduce and enforce test contract annotations for critical modules and update coverage tracking.

Browse Source
This commit is contained in:
busya
2026-03-04 12:58:42 +03:00
parent 09e59ba88b
commit 7194f6a4c4
16 changed files with 15569 additions and 3336 deletions
Download Patch File Download Diff File Expand all files Collapse all files

341
.ai/MODULE_MAP.md
View File

@@ -2,12 +2,12 @@
> High-level module structure for AI Context. Generated automatically. > High-level module structure for AI Context. Generated automatically.
**Generated:** 2026-03-01T12:09:39.463912 **Generated:** 2026-03-04T11:13:41.118516
## Summary ## Summary
- **Total Modules:** 80 - **Total Modules:** 84
- **Total Entities:** 2080 - **Total Entities:** 2288
## Module Hierarchy ## Module Hierarchy
@@ -28,9 +28,9 @@
### 📁 `src/` ### 📁 `src/`
- 🏗️ **Layers:** API, Core, UI (API) - 🏗️ **Layers:** API, Core, UI (API)
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 19, TRIVIAL: 2 - 📊 **Tiers:** CRITICAL: 2, STANDARD: 20, TRIVIAL: 2
- 📄 **Files:** 2 - 📄 **Files:** 2
- 📦 **Entities:** 23 - 📦 **Entities:** 24
**Key Entities:** **Key Entities:**
@@ -42,21 +42,21 @@
### 📁 `api/` ### 📁 `api/`
- 🏗️ **Layers:** API - 🏗️ **Layers:** API
- 📊 **Tiers:** STANDARD: 7 - 📊 **Tiers:** CRITICAL: 7
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 7 - 📦 **Entities:** 7
**Key Entities:** **Key Entities:**
- 📦 **backend.src.api.auth** (Module) - 📦 **backend.src.api.auth** (Module) `[CRITICAL]`
- Authentication API endpoints. - Authentication API endpoints.
### 📁 `routes/` ### 📁 `routes/`
- 🏗️ **Layers:** API, UI (API) - 🏗️ **Layers:** API, UI (API)
- 📊 **Tiers:** CRITICAL: 3, STANDARD: 205, TRIVIAL: 7 - 📊 **Tiers:** CRITICAL: 11, STANDARD: 226, TRIVIAL: 8
- 📄 **Files:** 17 - 📄 **Files:** 18
- 📦 **Entities:** 215 - 📦 **Entities:** 245
**Key Entities:** **Key Entities:**
@@ -126,7 +126,7 @@
### 📁 `core/` ### 📁 `core/`
- 🏗️ **Layers:** Core - 🏗️ **Layers:** Core
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 131, TRIVIAL: 8 - 📊 **Tiers:** CRITICAL: 45, STANDARD: 88, TRIVIAL: 8
- 📄 **Files:** 10 - 📄 **Files:** 10
- 📦 **Entities:** 141 - 📦 **Entities:** 141
@@ -136,13 +136,13 @@
- A session factory for the authentication database. - A session factory for the authentication database.
- ℂ **BeliefFormatter** (Class) - ℂ **BeliefFormatter** (Class)
- Custom logging formatter that adds belief state prefixes to ... - Custom logging formatter that adds belief state prefixes to ...
- ℂ **ConfigManager** (Class) - ℂ **ConfigManager** (Class) `[CRITICAL]`
- A class to handle application configuration persistence and ... - A class to handle application configuration persistence and ...
- ℂ **IdMappingService** (Class) `[CRITICAL]` - ℂ **IdMappingService** (Class) `[CRITICAL]`
- Service handling the cataloging and retrieval of remote Supe... - Service handling the cataloging and retrieval of remote Supe...
- ℂ **LogEntry** (Class) - ℂ **LogEntry** (Class)
- A Pydantic model representing a single, structured log entry... - A Pydantic model representing a single, structured log entry...
- ℂ **MigrationEngine** (Class) - ℂ **MigrationEngine** (Class) `[CRITICAL]`
- Engine for transforming Superset export ZIPs. - Engine for transforming Superset export ZIPs.
- ℂ **PluginBase** (Class) - ℂ **PluginBase** (Class)
- Defines the abstract base class that all plugins must implem... - Defines the abstract base class that all plugins must implem...
@@ -164,27 +164,27 @@
### 📁 `auth/` ### 📁 `auth/`
- 🏗️ **Layers:** Core - 🏗️ **Layers:** Core
- 📊 **Tiers:** STANDARD: 26 - 📊 **Tiers:** CRITICAL: 26
- 📄 **Files:** 6 - 📄 **Files:** 6
- 📦 **Entities:** 26 - 📦 **Entities:** 26
**Key Entities:** **Key Entities:**
- ℂ **AuthConfig** (Class) - ℂ **AuthConfig** (Class) `[CRITICAL]`
- Holds authentication-related settings. - Holds authentication-related settings.
- ℂ **AuthRepository** (Class) - ℂ **AuthRepository** (Class) `[CRITICAL]`
- Encapsulates database operations for authentication. - Encapsulates database operations for authentication.
- 📦 **backend.src.core.auth.config** (Module) - 📦 **backend.src.core.auth.config** (Module) `[CRITICAL]`
- Centralized configuration for authentication and authorizati... - Centralized configuration for authentication and authorizati...
- 📦 **backend.src.core.auth.jwt** (Module) - 📦 **backend.src.core.auth.jwt** (Module) `[CRITICAL]`
- JWT token generation and validation logic. - JWT token generation and validation logic.
- 📦 **backend.src.core.auth.logger** (Module) - 📦 **backend.src.core.auth.logger** (Module) `[CRITICAL]`
- Audit logging for security-related events. - Audit logging for security-related events.
- 📦 **backend.src.core.auth.oauth** (Module) - 📦 **backend.src.core.auth.oauth** (Module) `[CRITICAL]`
- ADFS OIDC configuration and client using Authlib. - ADFS OIDC configuration and client using Authlib.
- 📦 **backend.src.core.auth.repository** (Module) - 📦 **backend.src.core.auth.repository** (Module) `[CRITICAL]`
- Data access layer for authentication-related entities. - Data access layer for authentication-related entities.
- 📦 **backend.src.core.auth.security** (Module) - 📦 **backend.src.core.auth.security** (Module) `[CRITICAL]`
- Utility for password hashing and verification using Passlib. - Utility for password hashing and verification using Passlib.
**Dependencies:** **Dependencies:**
@@ -222,23 +222,23 @@
### 📁 `migration/` ### 📁 `migration/`
- 🏗️ **Layers:** Core - 🏗️ **Layers:** Core
- 📊 **Tiers:** STANDARD: 20, TRIVIAL: 1 - 📊 **Tiers:** CRITICAL: 20, TRIVIAL: 1
- 📄 **Files:** 4 - 📄 **Files:** 4
- 📦 **Entities:** 21 - 📦 **Entities:** 21
**Key Entities:** **Key Entities:**
- ℂ **MigrationArchiveParser** (Class) - ℂ **MigrationArchiveParser** (Class) `[CRITICAL]`
- Extract normalized dashboards/charts/datasets metadata from ... - Extract normalized dashboards/charts/datasets metadata from ...
- ℂ **MigrationDryRunService** (Class) - ℂ **MigrationDryRunService** (Class) `[CRITICAL]`
- Build deterministic diff/risk payload for migration pre-flig... - Build deterministic diff/risk payload for migration pre-flig...
- 📦 **backend.src.core.migration.__init__** (Module) `[TRIVIAL]` - 📦 **backend.src.core.migration.__init__** (Module) `[TRIVIAL]`
- Namespace package for migration pre-flight orchestration com... - Namespace package for migration pre-flight orchestration com...
- 📦 **backend.src.core.migration.archive_parser** (Module) - 📦 **backend.src.core.migration.archive_parser** (Module) `[CRITICAL]`
- Parse Superset export ZIP archives into normalized object ca... - Parse Superset export ZIP archives into normalized object ca...
- 📦 **backend.src.core.migration.dry_run_orchestrator** (Module) - 📦 **backend.src.core.migration.dry_run_orchestrator** (Module) `[CRITICAL]`
- Compute pre-flight migration diff and risk scoring without a... - Compute pre-flight migration diff and risk scoring without a...
- 📦 **backend.src.core.migration.risk_assessor** (Module) - 📦 **backend.src.core.migration.risk_assessor** (Module) `[CRITICAL]`
- Risk evaluation helpers for migration pre-flight reporting. - Risk evaluation helpers for migration pre-flight reporting.
**Dependencies:** **Dependencies:**
@@ -288,9 +288,9 @@
### 📁 `utils/` ### 📁 `utils/`
- 🏗️ **Layers:** Core, Domain, Infra - 🏗️ **Layers:** Core, Domain, Infra
- 📊 **Tiers:** STANDARD: 48, TRIVIAL: 1 - 📊 **Tiers:** STANDARD: 50, TRIVIAL: 1
- 📄 **Files:** 4 - 📄 **Files:** 4
- 📦 **Entities:** 49 - 📦 **Entities:** 51
**Key Entities:** **Key Entities:**
@@ -326,15 +326,15 @@
### 📁 `models/` ### 📁 `models/`
- 🏗️ **Layers:** Domain, Model - 🏗️ **Layers:** Domain, Model
- 📊 **Tiers:** CRITICAL: 9, STANDARD: 22, TRIVIAL: 22 - 📊 **Tiers:** CRITICAL: 20, STANDARD: 33, TRIVIAL: 29
- 📄 **Files:** 11 - 📄 **Files:** 12
- 📦 **Entities:** 53 - 📦 **Entities:** 82
**Key Entities:** **Key Entities:**
- ℂ **ADGroupMapping** (Class) - ℂ **ADGroupMapping** (Class) `[CRITICAL]`
- Maps an Active Directory group to a local System Role. - Maps an Active Directory group to a local System Role.
- ℂ **AppConfigRecord** (Class) - ℂ **AppConfigRecord** (Class) `[CRITICAL]`
- Stores the single source of truth for application configurat... - Stores the single source of truth for application configurat...
- ℂ **AssistantAuditRecord** (Class) - ℂ **AssistantAuditRecord** (Class)
- Store audit decisions and outcomes produced by assistant com... - Store audit decisions and outcomes produced by assistant com...
@@ -342,16 +342,16 @@
- Persist risky operation confirmation tokens with lifecycle s... - Persist risky operation confirmation tokens with lifecycle s...
- ℂ **AssistantMessageRecord** (Class) - ℂ **AssistantMessageRecord** (Class)
- Persist chat history entries for assistant conversations. - Persist chat history entries for assistant conversations.
- ℂ **ConnectionConfig** (Class) `[TRIVIAL]` - ℂ **CheckFinalStatus** (Class)
- Stores credentials for external databases used for column ma... - Final status for compliance check run.
- ℂ **DashboardMetadata** (Class) `[TRIVIAL]` - ℂ **CheckStageName** (Class)
- Represents a dashboard available for migration. - Mandatory check stages.
- ℂ **DashboardSelection** (Class) `[TRIVIAL]` - ℂ **CheckStageResult** (Class)
- Represents the user's selection of dashboards to migrate. - Per-stage compliance result.
- ℂ **DatabaseMapping** (Class) - ℂ **CheckStageStatus** (Class)
- Represents a mapping between source and target databases. - Stage-level execution status.
- ℂ **DeploymentEnvironment** (Class) `[TRIVIAL]` - ℂ **ClassificationType** (Class)
- Target Superset environments for dashboard deployment. - Manifest classification outcomes for artifacts.
**Dependencies:** **Dependencies:**
@@ -378,7 +378,7 @@
### 📁 `plugins/` ### 📁 `plugins/`
- 🏗️ **Layers:** App, Plugin, Plugins - 🏗️ **Layers:** App, Plugin, Plugins
- 📊 **Tiers:** STANDARD: 63 - 📊 **Tiers:** CRITICAL: 10, STANDARD: 53
- 📄 **Files:** 6 - 📄 **Files:** 6
- 📦 **Entities:** 63 - 📦 **Entities:** 63
@@ -392,7 +392,7 @@
- Реализация плагина Git Integration для управления версиями д... - Реализация плагина Git Integration для управления версиями д...
- ℂ **MapperPlugin** (Class) - ℂ **MapperPlugin** (Class)
- Plugin for mapping dataset columns verbose names. - Plugin for mapping dataset columns verbose names.
- ℂ **MigrationPlugin** (Class) - ℂ **MigrationPlugin** (Class) `[CRITICAL]`
- Implementation of the migration plugin logic. - Implementation of the migration plugin logic.
- ℂ **SearchPlugin** (Class) - ℂ **SearchPlugin** (Class)
- Plugin for searching text patterns in Superset datasets. - Plugin for searching text patterns in Superset datasets.
@@ -402,7 +402,7 @@
- Implements a plugin for system diagnostics and debugging Sup... - Implements a plugin for system diagnostics and debugging Sup...
- 📦 **MapperPluginModule** (Module) - 📦 **MapperPluginModule** (Module)
- Implements a plugin for mapping dataset columns using extern... - Implements a plugin for mapping dataset columns using extern...
- 📦 **MigrationPlugin** (Module) - 📦 **MigrationPlugin** (Module) `[CRITICAL]`
- A plugin that provides functionality to migrate Superset das... - A plugin that provides functionality to migrate Superset das...
**Dependencies:** **Dependencies:**
@@ -481,31 +481,31 @@
### 📁 `schemas/` ### 📁 `schemas/`
- 🏗️ **Layers:** API - 🏗️ **Layers:** API
- 📊 **Tiers:** STANDARD: 10, TRIVIAL: 3 - 📊 **Tiers:** CRITICAL: 10, TRIVIAL: 3
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 13 - 📦 **Entities:** 13
**Key Entities:** **Key Entities:**
- ℂ **ADGroupMappingCreate** (Class) - ℂ **ADGroupMappingCreate** (Class) `[CRITICAL]`
- Schema for creating an AD Group mapping. - Schema for creating an AD Group mapping.
- ℂ **ADGroupMappingSchema** (Class) - ℂ **ADGroupMappingSchema** (Class) `[CRITICAL]`
- Represents an AD Group to Role mapping in API responses. - Represents an AD Group to Role mapping in API responses.
- ℂ **PermissionSchema** (Class) `[TRIVIAL]` - ℂ **PermissionSchema** (Class) `[TRIVIAL]`
- Represents a permission in API responses. - Represents a permission in API responses.
- ℂ **RoleCreate** (Class) - ℂ **RoleCreate** (Class) `[CRITICAL]`
- Schema for creating a new role. - Schema for creating a new role.
- ℂ **RoleSchema** (Class) - ℂ **RoleSchema** (Class) `[CRITICAL]`
- Represents a role in API responses. - Represents a role in API responses.
- ℂ **RoleUpdate** (Class) - ℂ **RoleUpdate** (Class) `[CRITICAL]`
- Schema for updating an existing role. - Schema for updating an existing role.
- ℂ **Token** (Class) `[TRIVIAL]` - ℂ **Token** (Class) `[TRIVIAL]`
- Represents a JWT access token response. - Represents a JWT access token response.
- ℂ **TokenData** (Class) `[TRIVIAL]` - ℂ **TokenData** (Class) `[TRIVIAL]`
- Represents the data encoded in a JWT token. - Represents the data encoded in a JWT token.
- ℂ **User** (Class) - ℂ **User** (Class) `[CRITICAL]`
- Schema for user data in API responses. - Schema for user data in API responses.
- ℂ **UserBase** (Class) - ℂ **UserBase** (Class) `[CRITICAL]`
- Base schema for user data. - Base schema for user data.
**Dependencies:** **Dependencies:**
@@ -514,16 +514,18 @@
### 📁 `scripts/` ### 📁 `scripts/`
- 🏗️ **Layers:** Scripts, Unknown - 🏗️ **Layers:** Scripts, UI, Unknown
- 📊 **Tiers:** STANDARD: 26, TRIVIAL: 2 - 📊 **Tiers:** CRITICAL: 2, STANDARD: 25, TRIVIAL: 3
- 📄 **Files:** 6 - 📄 **Files:** 7
- 📦 **Entities:** 28 - 📦 **Entities:** 30
**Key Entities:** **Key Entities:**
- 📦 **backend.src.scripts.clean_release_tui** (Module)
- Provide clean release TUI entrypoint placeholder for phased ...
- 📦 **backend.src.scripts.create_admin** (Module) - 📦 **backend.src.scripts.create_admin** (Module)
- CLI tool for creating the initial admin user. - CLI tool for creating the initial admin user.
- 📦 **backend.src.scripts.init_auth_db** (Module) - 📦 **backend.src.scripts.init_auth_db** (Module) `[CRITICAL]`
- Initializes the auth database and creates the necessary tabl... - Initializes the auth database and creates the necessary tabl...
- 📦 **backend.src.scripts.migrate_sqlite_to_postgres** (Module) - 📦 **backend.src.scripts.migrate_sqlite_to_postgres** (Module)
- Migrates legacy config and task history from SQLite/file sto... - Migrates legacy config and task history from SQLite/file sto...
@@ -537,13 +539,13 @@
### 📁 `services/` ### 📁 `services/`
- 🏗️ **Layers:** Core, Domain, Service - 🏗️ **Layers:** Core, Domain, Service
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 62, TRIVIAL: 6 - 📊 **Tiers:** CRITICAL: 7, STANDARD: 75, TRIVIAL: 6
- 📄 **Files:** 7 - 📄 **Files:** 7
- 📦 **Entities:** 69 - 📦 **Entities:** 88
**Key Entities:** **Key Entities:**
- ℂ **AuthService** (Class) - ℂ **AuthService** (Class) `[CRITICAL]`
- Provides high-level authentication services. - Provides high-level authentication services.
- ℂ **EncryptionManager** (Class) `[CRITICAL]` - ℂ **EncryptionManager** (Class) `[CRITICAL]`
- Handles encryption and decryption of sensitive data like API... - Handles encryption and decryption of sensitive data like API...
@@ -557,7 +559,7 @@
- Provides centralized access to resource data with enhanced m... - Provides centralized access to resource data with enhanced m...
- 📦 **backend.src.services** (Module) - 📦 **backend.src.services** (Module)
- Package initialization for services module - Package initialization for services module
- 📦 **backend.src.services.auth_service** (Module) - 📦 **backend.src.services.auth_service** (Module) `[CRITICAL]`
- Orchestrates authentication business logic. - Orchestrates authentication business logic.
- 📦 **backend.src.services.git_service** (Module) - 📦 **backend.src.services.git_service** (Module)
- Core Git logic using GitPython to manage dashboard repositor... - Core Git logic using GitPython to manage dashboard repositor...
@@ -594,6 +596,57 @@
- 🔗 DEPENDS_ON -> backend.src.services.llm_prompt_templates - 🔗 DEPENDS_ON -> backend.src.services.llm_prompt_templates
### 📁 `clean_release/`
- 🏗️ **Layers:** Domain, Infra
- 📊 **Tiers:** CRITICAL: 3, STANDARD: 12, TRIVIAL: 33
- 📄 **Files:** 10
- 📦 **Entities:** 48
**Key Entities:**
- ℂ **CleanPolicyEngine** (Class)
- 📦 **backend.src.services.clean_release** (Module)
- Initialize clean release service package and provide explici...
- 📦 **backend.src.services.clean_release.audit_service** (Module)
- Provide lightweight audit hooks for clean release preparatio...
- 📦 **backend.src.services.clean_release.compliance_orchestrator** (Module) `[CRITICAL]`
- Execute mandatory clean compliance stages and produce final ...
- 📦 **backend.src.services.clean_release.manifest_builder** (Module)
- Build deterministic distribution manifest from classified ar...
- 📦 **backend.src.services.clean_release.policy_engine** (Module) `[CRITICAL]`
- Evaluate artifact/source policies for enterprise clean profi...
- 📦 **backend.src.services.clean_release.preparation_service** (Module)
- Prepare release candidate by policy evaluation and determini...
- 📦 **backend.src.services.clean_release.report_builder** (Module) `[CRITICAL]`
- Build and persist compliance reports with consistent counter...
- 📦 **backend.src.services.clean_release.repository** (Module)
- Provide repository adapter for clean release entities with d...
- 📦 **backend.src.services.clean_release.source_isolation** (Module)
- Validate that all resource endpoints belong to the approved ...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.core.logger
- 🔗 DEPENDS_ON -> backend.src.models.clean_release
- 🔗 DEPENDS_ON -> backend.src.models.clean_release.CleanProfilePolicy
- 🔗 DEPENDS_ON -> backend.src.models.clean_release.ResourceSourceRegistry
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.manifest_builder
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 12
- 📄 **Files:** 2
- 📦 **Entities:** 12
**Key Entities:**
- 📦 **backend.tests.services.clean_release.test_compliance_orchestrator** (Module)
- Validate compliance orchestrator stage transitions and final...
- 📦 **backend.tests.services.clean_release.test_report_builder** (Module)
- Validate compliance report builder counter integrity and blo...
### 📁 `reports/` ### 📁 `reports/`
- 🏗️ **Layers:** Domain - 🏗️ **Layers:** Domain
@@ -636,43 +689,59 @@
### 📁 `tests/` ### 📁 `tests/`
- 🏗️ **Layers:** Core, Domain (Tests), Test, Unknown - 🏗️ **Layers:** Core, Domain (Tests), Logging (Tests), Test, Unknown
- 📊 **Tiers:** CRITICAL: 6, STANDARD: 79, TRIVIAL: 85 - 📊 **Tiers:** STANDARD: 86, TRIVIAL: 85
- 📄 **Files:** 10 - 📄 **Files:** 10
- 📦 **Entities:** 170 - 📦 **Entities:** 171
**Key Entities:** **Key Entities:**
- ℂ **TestLogPersistence** (Class) `[CRITICAL]` - ℂ **TestLogPersistence** (Class)
- Test suite for TaskLogPersistenceService. - Test suite for TaskLogPersistenceService.
- ℂ **TestTaskContext** (Class) - ℂ **TestTaskContext** (Class)
- Test suite for TaskContext. - Test suite for TaskContext.
- ℂ **TestTaskLogger** (Class) - ℂ **TestTaskLogger** (Class)
- Test suite for TaskLogger. - Test suite for TaskLogger.
- ℂ **TestTaskPersistenceHelpers** (Class) `[CRITICAL]` - ℂ **TestTaskPersistenceHelpers** (Class)
- Test suite for TaskPersistenceService static helper methods. - Test suite for TaskPersistenceService static helper methods.
- ℂ **TestTaskPersistenceService** (Class) `[CRITICAL]` - ℂ **TestTaskPersistenceService** (Class)
- Test suite for TaskPersistenceService CRUD operations. - Test suite for TaskPersistenceService CRUD operations.
- 📦 **backend.tests.test_dashboards_api** (Module) - 📦 **backend.tests.test_dashboards_api** (Module)
- Comprehensive contract-driven tests for Dashboard Hub API - Comprehensive contract-driven tests for Dashboard Hub API
- 📦 **test_auth** (Module) `[TRIVIAL]` - 📦 **test_auth** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_auth.py - Auto-generated module for backend/tests/test_auth.py
- 📦 **test_log_persistence** (Module) `[CRITICAL]` - 📦 **test_log_persistence** (Module)
- Unit tests for TaskLogPersistenceService. - Unit tests for TaskLogPersistenceService.
- 📦 **test_resource_hubs** (Module) `[TRIVIAL]` - 📦 **test_resource_hubs** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_resource_hubs.p... - Auto-generated module for backend/tests/test_resource_hubs.p...
- 📦 **test_smoke_plugins** (Module) `[TRIVIAL]` - 📦 **test_smoke_plugins** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_smoke_plugins.p... - Auto-generated module for backend/tests/test_smoke_plugins.p...
### 📁 `routes/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 5
- 📄 **Files:** 2
- 📦 **Entities:** 7
**Key Entities:**
- 📦 **backend.tests.api.routes.test_clean_release_api** (Module)
- Contract tests for clean release checks and reports endpoint...
- 📦 **backend.tests.api.routes.test_clean_release_source_policy** (Module)
- Validate API behavior for source isolation violations in cle...
### 📁 `core/` ### 📁 `core/`
- 🏗️ **Layers:** Domain, Unknown - 🏗️ **Layers:** Domain, Unknown
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 31 - 📊 **Tiers:** STANDARD: 5, TRIVIAL: 32
- 📄 **Files:** 3 - 📄 **Files:** 4
- 📦 **Entities:** 33 - 📦 **Entities:** 37
**Key Entities:** **Key Entities:**
- 📦 **backend.tests.core.test_git_service_gitea_pr** (Module)
- Validate Gitea PR creation fallback behavior when configured...
- 📦 **backend.tests.core.test_mapping_service** (Module) - 📦 **backend.tests.core.test_mapping_service** (Module)
- Unit tests for the IdMappingService matching UUIDs to intege... - Unit tests for the IdMappingService matching UUIDs to intege...
- 📦 **backend.tests.core.test_migration_engine** (Module) - 📦 **backend.tests.core.test_migration_engine** (Module)
@@ -694,10 +763,26 @@
- 📦 **backend.tests.core.migration.test_dry_run_orchestrator** (Module) - 📦 **backend.tests.core.migration.test_dry_run_orchestrator** (Module)
- Unit tests for MigrationDryRunService diff and risk computat... - Unit tests for MigrationDryRunService diff and risk computat...
### 📁 `clean_release/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 11, TRIVIAL: 5
- 📄 **Files:** 3
- 📦 **Entities:** 16
**Key Entities:**
- 📦 **backend.tests.services.clean_release.test_manifest_builder** (Module)
- Validate deterministic manifest generation behavior for US1.
- 📦 **backend.tests.services.clean_release.test_policy_engine** (Module)
- Validate policy model contracts and deterministic classifica...
- 📦 **backend.tests.services.clean_release.test_source_isolation** (Module)
- Verify internal source registry validation behavior.
### 📁 `components/` ### 📁 `components/`
- 🏗️ **Layers:** Component, Feature, UI, UI -->, Unknown - 🏗️ **Layers:** Component, Feature, UI, UI -->, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 68, TRIVIAL: 4 - 📊 **Tiers:** STANDARD: 69, TRIVIAL: 4
- 📄 **Files:** 14 - 📄 **Files:** 14
- 📦 **Entities:** 73 - 📦 **Entities:** 73
@@ -751,9 +836,9 @@
### 📁 `git/` ### 📁 `git/`
- 🏗️ **Layers:** Component - 🏗️ **Layers:** Component
- 📊 **Tiers:** STANDARD: 28 - 📊 **Tiers:** STANDARD: 45
- 📄 **Files:** 6 - 📄 **Files:** 6
- 📦 **Entities:** 28 - 📦 **Entities:** 45
**Key Entities:** **Key Entities:**
@@ -768,12 +853,12 @@
- 🧩 **DeploymentModal** (Component) - 🧩 **DeploymentModal** (Component)
- Modal for deploying a dashboard to a target environment. - Modal for deploying a dashboard to a target environment.
- 🧩 **GitManager** (Component) - 🧩 **GitManager** (Component)
- Центральный компонент для управления Git-операциями конкретн... - Центральный UI управления Git с фокусом на рабочий поток ана...
### 📁 `llm/` ### 📁 `llm/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 11 - 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 11
- 📄 **Files:** 3 - 📄 **Files:** 3
- 📦 **Entities:** 13 - 📦 **Entities:** 13
@@ -781,7 +866,7 @@
- 🧩 **DocPreview** (Component) - 🧩 **DocPreview** (Component)
- UI component for previewing generated dataset documentation ... - UI component for previewing generated dataset documentation ...
- 🧩 **ProviderConfig** (Component) - 🧩 **ProviderConfig** (Component) `[CRITICAL]`
- UI form for managing LLM provider configurations. - UI form for managing LLM provider configurations.
- 📦 **DocPreview** (Module) `[TRIVIAL]` - 📦 **DocPreview** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/llm/DocPre... - Auto-generated module for frontend/src/components/llm/DocPre...
@@ -861,9 +946,9 @@
### 📁 `lib/` ### 📁 `lib/`
- 🏗️ **Layers:** Infra, Infra-API, UI, UI-State - 🏗️ **Layers:** Infra, Infra-API, UI, UI-State
- 📊 **Tiers:** STANDARD: 24, TRIVIAL: 3 - 📊 **Tiers:** STANDARD: 24, TRIVIAL: 5
- 📄 **Files:** 5 - 📄 **Files:** 5
- 📦 **Entities:** 27 - 📦 **Entities:** 29
**Key Entities:** **Key Entities:**
@@ -918,25 +1003,25 @@
### 📁 `auth/` ### 📁 `auth/`
- 🏗️ **Layers:** Feature - 🏗️ **Layers:** Feature
- 📊 **Tiers:** STANDARD: 7 - 📊 **Tiers:** CRITICAL: 7
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 7 - 📦 **Entities:** 7
**Key Entities:** **Key Entities:**
- 🗄️ **authStore** (Store) - 🗄️ **authStore** (Store) `[CRITICAL]`
- Manages the global authentication state on the frontend. - Manages the global authentication state on the frontend.
### 📁 `assistant/` ### 📁 `assistant/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 13, TRIVIAL: 5 - 📊 **Tiers:** STANDARD: 14, TRIVIAL: 5
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 19 - 📦 **Entities:** 19
**Key Entities:** **Key Entities:**
- 🧩 **AssistantChatPanel** (Component) `[CRITICAL]` - 🧩 **AssistantChatPanel** (Component)
- Slide-out assistant chat panel for natural language command ... - Slide-out assistant chat panel for natural language command ...
- 📦 **AssistantChatPanel** (Module) `[TRIVIAL]` - 📦 **AssistantChatPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/assist... - Auto-generated module for frontend/src/lib/components/assist...
@@ -956,7 +1041,7 @@
### 📁 `layout/` ### 📁 `layout/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 3, STANDARD: 5, TRIVIAL: 48 - 📊 **Tiers:** STANDARD: 8, TRIVIAL: 48
- 📄 **Files:** 4 - 📄 **Files:** 4
- 📦 **Entities:** 56 - 📦 **Entities:** 56
@@ -964,11 +1049,11 @@
- 🧩 **Breadcrumbs** (Component) - 🧩 **Breadcrumbs** (Component)
- Display page hierarchy navigation - Display page hierarchy navigation
- 🧩 **Sidebar** (Component) `[CRITICAL]` - 🧩 **Sidebar** (Component)
- Persistent left sidebar with resource categories navigation - Persistent left sidebar with resource categories navigation
- 🧩 **TaskDrawer** (Component) `[CRITICAL]` - 🧩 **TaskDrawer** (Component)
- Global task drawer for monitoring background operations - Global task drawer for monitoring background operations
- 🧩 **TopNavbar** (Component) `[CRITICAL]` - 🧩 **TopNavbar** (Component)
- Unified top navigation bar with Logo, Search, Activity, and ... - Unified top navigation bar with Logo, Search, Activity, and ...
- 📦 **Breadcrumbs** (Module) `[TRIVIAL]` - 📦 **Breadcrumbs** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout... - Auto-generated module for frontend/src/lib/components/layout...
@@ -994,17 +1079,17 @@
### 📁 `reports/` ### 📁 `reports/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 4, STANDARD: 1, TRIVIAL: 10 - 📊 **Tiers:** CRITICAL: 1, STANDARD: 4, TRIVIAL: 10
- 📄 **Files:** 4 - 📄 **Files:** 4
- 📦 **Entities:** 15 - 📦 **Entities:** 15
**Key Entities:** **Key Entities:**
- 🧩 **ReportCard** (Component) `[CRITICAL]` - 🧩 **ReportCard** (Component)
- Render one report with explicit textual type label and profi... - Render one report with explicit textual type label and profi...
- 🧩 **ReportDetailPanel** (Component) `[CRITICAL]` - 🧩 **ReportDetailPanel** (Component)
- Display detailed report context with diagnostics and actiona... - Display detailed report context with diagnostics and actiona...
- 🧩 **ReportsList** (Component) `[CRITICAL]` - 🧩 **ReportsList** (Component)
- Render unified list of normalized reports with canonical min... - Render unified list of normalized reports with canonical min...
- 📦 **ReportCard** (Module) `[TRIVIAL]` - 📦 **ReportCard** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/report... - Auto-generated module for frontend/src/lib/components/report...
@@ -1260,9 +1345,9 @@
### 📁 `dashboards/` ### 📁 `dashboards/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 23, TRIVIAL: 60 - 📊 **Tiers:** STANDARD: 24, TRIVIAL: 61
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 84 - 📦 **Entities:** 85
**Key Entities:** **Key Entities:**
@@ -1272,9 +1357,9 @@
### 📁 `[id]/` ### 📁 `[id]/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 17 - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 28
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 18 - 📦 **Entities:** 29
**Key Entities:** **Key Entities:**
@@ -1284,7 +1369,7 @@
### 📁 `datasets/` ### 📁 `datasets/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 15 - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 15
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 16 - 📦 **Entities:** 16
@@ -1296,7 +1381,7 @@
### 📁 `[id]/` ### 📁 `[id]/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 6 - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 6
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 7 - 📦 **Entities:** 7
@@ -1332,26 +1417,26 @@
### 📁 `migration/` ### 📁 `migration/`
- 🏗️ **Layers:** Page - 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 11 - 📊 **Tiers:** CRITICAL: 11
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 11 - 📦 **Entities:** 11
**Key Entities:** **Key Entities:**
- 🧩 **DashboardSelectionSection** (Component) - 🧩 **DashboardSelectionSection** (Component) `[CRITICAL]`
- 🧩 **MigrationDashboard** (Component) - 🧩 **MigrationDashboard** (Component) `[CRITICAL]`
- Main dashboard for configuring and starting migrations. - Main dashboard for configuring and starting migrations.
### 📁 `mappings/` ### 📁 `mappings/`
- 🏗️ **Layers:** Page - 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 4 - 📊 **Tiers:** CRITICAL: 4
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 4 - 📦 **Entities:** 4
**Key Entities:** **Key Entities:**
- 🧩 **MappingManagement** (Component) - 🧩 **MappingManagement** (Component) `[CRITICAL]`
- Page for managing database mappings between environments. - Page for managing database mappings between environments.
### 📁 `reports/` ### 📁 `reports/`
@@ -1383,9 +1468,9 @@
### 📁 `settings/` ### 📁 `settings/`
- 🏗️ **Layers:** UI, Unknown - 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 23 - 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 25
- 📄 **Files:** 2 - 📄 **Files:** 2
- 📦 **Entities:** 25 - 📦 **Entities:** 27
**Key Entities:** **Key Entities:**
@@ -1407,9 +1492,9 @@
### 📁 `git/` ### 📁 `git/`
- 🏗️ **Layers:** Page - 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 5 - 📊 **Tiers:** STANDARD: 8
- 📄 **Files:** 1 - 📄 **Files:** 1
- 📦 **Entities:** 5 - 📦 **Entities:** 8
**Key Entities:** **Key Entities:**
@@ -1468,9 +1553,9 @@
### 📁 `services/` ### 📁 `services/`
- 🏗️ **Layers:** Service - 🏗️ **Layers:** Service
- 📊 **Tiers:** STANDARD: 33 - 📊 **Tiers:** STANDARD: 33, TRIVIAL: 1
- 📄 **Files:** 6 - 📄 **Files:** 6
- 📦 **Entities:** 33 - 📦 **Entities:** 34
**Key Entities:** **Key Entities:**
@@ -1500,7 +1585,7 @@
### 📁 `root/` ### 📁 `root/`
- 🏗️ **Layers:** DevOps/Tooling, Domain, Unknown - 🏗️ **Layers:** DevOps/Tooling, Domain, Unknown
- 📊 **Tiers:** CRITICAL: 14, STANDARD: 24, TRIVIAL: 12 - 📊 **Tiers:** CRITICAL: 11, STANDARD: 27, TRIVIAL: 12
- 📄 **Files:** 4 - 📄 **Files:** 4
- 📦 **Entities:** 50 - 📦 **Entities:** 50
@@ -1508,7 +1593,7 @@
- ℂ **ComplianceIssue** (Class) `[TRIVIAL]` - ℂ **ComplianceIssue** (Class) `[TRIVIAL]`
- Represents a single compliance issue with severity. - Represents a single compliance issue with severity.
- ℂ **ReportsService** (Class) `[CRITICAL]` - ℂ **ReportsService** (Class)
- Service layer for list/detail report retrieval and normaliza... - Service layer for list/detail report retrieval and normaliza...
- ℂ **SemanticEntity** (Class) `[CRITICAL]` - ℂ **SemanticEntity** (Class) `[CRITICAL]`
- Represents a code entity (Module, Function, Component) found... - Represents a code entity (Module, Function, Component) found...
@@ -1518,7 +1603,7 @@
- Severity levels for compliance issues. - Severity levels for compliance issues.
- ℂ **Tier** (Class) `[TRIVIAL]` - ℂ **Tier** (Class) `[TRIVIAL]`
- Enumeration of semantic tiers defining validation strictness... - Enumeration of semantic tiers defining validation strictness...
- 📦 **backend.src.services.reports.report_service** (Module) `[CRITICAL]` - 📦 **backend.src.services.reports.report_service** (Module)
- Aggregate, normalize, filter, and paginate task reports for ... - Aggregate, normalize, filter, and paginate task reports for ...
- 📦 **check_test_data** (Module) `[TRIVIAL]` - 📦 **check_test_data** (Module) `[TRIVIAL]`
- Auto-generated module for check_test_data.py - Auto-generated module for check_test_data.py
@@ -1566,6 +1651,8 @@ graph TD
routes-->|DEPENDS_ON|backend routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend 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__-->|TESTS|backend __tests__-->|TESTS|backend
@@ -1625,6 +1712,23 @@ graph TD
__tests__-->|TESTS|backend __tests__-->|TESTS|backend
__tests__-->|DEPENDS_ON|backend __tests__-->|DEPENDS_ON|backend
__tests__-->|TESTS|backend __tests__-->|TESTS|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
clean_release-->|DEPENDS_ON|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
reports-->|DEPENDS_ON|backend reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend reports-->|DEPENDS_ON|backend
@@ -1635,10 +1739,17 @@ graph TD
__tests__-->|TESTS|backend __tests__-->|TESTS|backend
__tests__-->|TESTS|backend __tests__-->|TESTS|backend
tests-->|TESTS|backend tests-->|TESTS|backend
routes-->|TESTS|backend
routes-->|TESTS|backend
core-->|TESTS|backend
core-->|VERIFIES|backend core-->|VERIFIES|backend
core-->|VERIFIES|backend core-->|VERIFIES|backend
migration-->|VERIFIES|backend migration-->|VERIFIES|backend
migration-->|VERIFIES|backend migration-->|VERIFIES|backend
clean_release-->|VERIFIES|backend
clean_release-->|VERIFIES|backend
clean_release-->|TESTS|backend
__tests__-->|VERIFIES|components
__tests__-->|VERIFIES|components __tests__-->|VERIFIES|components
__tests__-->|VERIFIES|lib __tests__-->|VERIFIES|lib
reports-->|DEPENDS_ON|lib reports-->|DEPENDS_ON|lib

913
.ai/PROJECT_MAP.md
View File

File diff suppressed because it is too large Load Diff

6
backend/src/api/routes/__tests__/test_dashboards.py
View File

@@ -97,10 +97,10 @@ def test_get_dashboards_with_search(mock_deps):
mock_deps["config"].get_environments.return_value = [mock_env] mock_deps["config"].get_environments.return_value = [mock_env]
mock_deps["task"].get_all_tasks.return_value = [] mock_deps["task"].get_all_tasks.return_value = []
async def mock_get_dashboards(env, tasks): async def mock_get_dashboards(env, tasks, include_git_status=False):
return [ return [
{"id": 1, "title": "Sales Report", "slug": "sales"}, {"id": 1, "title": "Sales Report", "slug": "sales", "git_status": {"branch": "main", "sync_status": "OK"}, "last_task": None},
{"id": 2, "title": "Marketing Dashboard", "slug": "marketing"} {"id": 2, "title": "Marketing Dashboard", "slug": "marketing", "git_status": {"branch": "main", "sync_status": "OK"}, "last_task": None}
] ]
mock_deps["resource"].get_dashboards_with_status = AsyncMock( mock_deps["resource"].get_dashboards_with_status = AsyncMock(
side_effect=mock_get_dashboards side_effect=mock_get_dashboards

7
backend/src/api/routes/tasks.py
View File

@@ -182,6 +182,13 @@ async def get_task(
# @POST: Returns a list of log entries or raises 404. # @POST: Returns a list of log entries or raises 404.
# @RETURN: List[LogEntry] - List of log entries. # @RETURN: List[LogEntry] - List of log entries.
# @TIER: CRITICAL # @TIER: CRITICAL
# @TEST_CONTRACT: TaskLogQueryInput -> List[LogEntry]
# @TEST_SCENARIO: existing_task_logs_filtered -> Returns filtered logs by level/source/search with pagination.
# @TEST_FIXTURE: valid_task_with_mixed_logs -> backend/tests/fixtures/task_logs/valid_task_with_mixed_logs.json
# @TEST_EDGE: missing_task -> Unknown task_id returns 404 Task not found.
# @TEST_EDGE: invalid_level_type -> Non-string/invalid level query rejected by validation or yields empty result.
# @TEST_EDGE: pagination_bounds -> offset=0 and limit=1000 remain within API bounds and do not overflow.
# @TEST_INVARIANT: logs_only_for_existing_task -> VERIFIED_BY: [existing_task_logs_filtered, missing_task]
async def get_task_logs( async def get_task_logs(
task_id: str, task_id: str,
level: Optional[str] = Query(None, description="Filter by log level (DEBUG, INFO, WARNING, ERROR)"), level: Optional[str] = Query(None, description="Filter by log level (DEBUG, INFO, WARNING, ERROR)"),

7
backend/src/models/clean_release.py
View File

@@ -5,6 +5,13 @@
# @LAYER: Domain # @LAYER: Domain
# @RELATION: BINDS_TO -> specs/023-clean-repo-enterprise/data-model.md # @RELATION: BINDS_TO -> specs/023-clean-repo-enterprise/data-model.md
# @INVARIANT: Enterprise-clean policy always forbids external sources. # @INVARIANT: Enterprise-clean policy always forbids external sources.
# @TEST_CONTRACT: CleanReleaseModelPayload -> ValidatedCleanReleaseModel | ValidationError
# @TEST_SCENARIO: valid_enterprise_models -> CRITICAL entities validate and preserve lifecycle/compliance invariants.
# @TEST_FIXTURE: clean_release_models_baseline -> backend/tests/fixtures/clean_release/fixtures_clean_release.json
# @TEST_EDGE: empty_required_identifiers -> Empty candidate_id/source_snapshot_ref/internal_source_registry_ref fails validation.
# @TEST_EDGE: compliant_run_missing_mandatory_stage -> COMPLIANT run without all mandatory PASS stages fails validation.
# @TEST_EDGE: blocked_report_without_blocking_violations -> BLOCKED report with zero blocking violations fails validation.
# @TEST_INVARIANT: external_source_must_block -> VERIFIED_BY: [valid_enterprise_models, blocked_report_without_blocking_violations]
from __future__ import annotations from __future__ import annotations

200
backend/src/scripts/dataset_dashboard_analysis.json
View File

@@ -9,8 +9,8 @@
"last_name": "Admin" "last_name": "Admin"
}, },
"changed_by_name": "Superset Admin", "changed_by_name": "Superset Admin",
"changed_on": "2026-02-10T13:39:35.945662", "changed_on": "2026-02-24T19:24:01.850617",
"changed_on_delta_humanized": "16 days ago", "changed_on_delta_humanized": "7 days ago",
"charts": [ "charts": [
"TA-0001-001 test_chart" "TA-0001-001 test_chart"
], ],
@@ -19,12 +19,12 @@
"id": 1, "id": 1,
"last_name": "Admin" "last_name": "Admin"
}, },
"created_on_delta_humanized": "16 days ago", "created_on_delta_humanized": "13 days ago",
"css": null, "css": null,
"dashboard_title": "TA-0001 Test dashboard", "dashboard_title": "TA-0001 Test dashboard",
"id": 13, "id": 13,
"is_managed_externally": false, "is_managed_externally": false,
"json_metadata": "{\"color_scheme_domain\": [], \"shared_label_colors\": [], \"map_label_colors\": {}, \"label_colors\": {}}", "json_metadata": "{\"color_scheme_domain\": [], \"shared_label_colors\": [], \"map_label_colors\": {}, \"label_colors\": {}, \"native_filter_configuration\": []}",
"owners": [ "owners": [
{ {
"first_name": "Superset", "first_name": "Superset",
@@ -32,13 +32,13 @@
"last_name": "Admin" "last_name": "Admin"
} }
], ],
"position_json": null, "position_json": "{\"DASHBOARD_VERSION_KEY\": \"v2\", \"ROOT_ID\": {\"children\": [\"GRID_ID\"], \"id\": \"ROOT_ID\", \"type\": \"ROOT\"}, \"GRID_ID\": {\"children\": [\"ROW-N-LH8TG1XX\"], \"id\": \"GRID_ID\", \"parents\": [\"ROOT_ID\"], \"type\": \"GRID\"}, \"HEADER_ID\": {\"id\": \"HEADER_ID\", \"meta\": {\"text\": \"TA-0001 Test dashboard\"}, \"type\": \"HEADER\"}, \"ROW-N-LH8TG1XX\": {\"children\": [\"CHART-1EKC8H7C\"], \"id\": \"ROW-N-LH8TG1XX\", \"meta\": {\"0\": \"ROOT_ID\", \"background\": \"BACKGROUND_TRANSPARENT\"}, \"type\": \"ROW\", \"parents\": [\"ROOT_ID\", \"GRID_ID\"]}, \"CHART-1EKC8H7C\": {\"children\": [], \"id\": \"CHART-1EKC8H7C\", \"meta\": {\"chartId\": 162, \"height\": 50, \"sliceName\": \"TA-0001-001 test_chart\", \"uuid\": \"008cdaa7-21b3-4042-9f55-f15653609ebd\", \"width\": 4}, \"type\": \"CHART\", \"parents\": [\"ROOT_ID\", \"GRID_ID\", \"ROW-N-LH8TG1XX\"]}}",
"published": true, "published": true,
"roles": [], "roles": [],
"slug": null, "slug": null,
"tags": [], "tags": [],
"theme": null, "theme": null,
"thumbnail_url": "/api/v1/dashboard/13/thumbnail/3cfc57e6aea7188b139f94fb437a1426/", "thumbnail_url": "/api/v1/dashboard/13/thumbnail/97dfd5d8d24f7cf01de45671c9a0699d/",
"url": "/superset/dashboard/13/", "url": "/superset/dashboard/13/",
"uuid": "124b28d4-d54a-4ade-ade7-2d0473b90686" "uuid": "124b28d4-d54a-4ade-ade7-2d0473b90686"
} }
@@ -53,15 +53,15 @@
"first_name": "Superset", "first_name": "Superset",
"last_name": "Admin" "last_name": "Admin"
}, },
"changed_on": "2026-02-10T13:38:26.175551", "changed_on": "2026-02-18T14:56:04.863722",
"changed_on_humanized": "16 days ago", "changed_on_humanized": "13 days ago",
"column_formats": {}, "column_formats": {},
"columns": [ "columns": [
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158196", "changed_on": "2026-02-18T14:56:05.382289",
"column_name": "color", "column_name": "has_2fa",
"created_on": "2026-02-10T13:38:26.158189", "created_on": "2026-02-18T14:56:05.382138",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -71,16 +71,16 @@
"is_active": true, "is_active": true,
"is_dttm": false, "is_dttm": false,
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "BOOLEAN",
"type_generic": 1, "type_generic": 3,
"uuid": "4fa810ee-99cc-4d1f-8c0d-0f289c3b01f4", "uuid": "fe374f2a-9e06-4708-89fd-c3926e3e5faa",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158249", "changed_on": "2026-02-18T14:56:05.545701",
"column_name": "deleted", "column_name": "is_ultra_restricted",
"created_on": "2026-02-10T13:38:26.158245", "created_on": "2026-02-18T14:56:05.545465",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -92,14 +92,14 @@
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "BOOLEAN",
"type_generic": 3, "type_generic": 3,
"uuid": "ebc07e82-7250-4eef-8d13-ea61561fa52c", "uuid": "eac7ecce-d472-4933-9652-d4f2811074fd",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158289", "changed_on": "2026-02-18T14:56:05.683578",
"column_name": "has_2fa", "column_name": "is_primary_owner",
"created_on": "2026-02-10T13:38:26.158285", "created_on": "2026-02-18T14:56:05.683257",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -111,14 +111,14 @@
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "BOOLEAN",
"type_generic": 3, "type_generic": 3,
"uuid": "08e72f4d-3ced-4d9a-9f7d-2f85291ce88b", "uuid": "94a15acd-ef98-425b-8f0d-1ce038ca95c5",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158328", "changed_on": "2026-02-18T14:56:05.758231",
"column_name": "id", "column_name": "is_app_user",
"created_on": "2026-02-10T13:38:26.158324", "created_on": "2026-02-18T14:56:05.758142",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -128,16 +128,16 @@
"is_active": true, "is_active": true,
"is_dttm": false, "is_dttm": false,
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "BOOLEAN",
"type_generic": 1, "type_generic": 3,
"uuid": "fd11955c-0130-4ea1-b3c0-d8b159971789", "uuid": "d3fcd712-dc96-4bba-a026-aa82022eccf5",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158366", "changed_on": "2026-02-18T14:56:05.799597",
"column_name": "is_admin", "column_name": "is_admin",
"created_on": "2026-02-10T13:38:26.158362", "created_on": "2026-02-18T14:56:05.799519",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -149,14 +149,14 @@
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "BOOLEAN",
"type_generic": 3, "type_generic": 3,
"uuid": "13a6c8e1-c9f8-4f08-aa62-05bca7be547b", "uuid": "5a1c9de5-80f1-4fe8-a91b-e6e530688aae",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158404", "changed_on": "2026-02-18T14:56:05.819443",
"column_name": "is_app_user", "column_name": "is_bot",
"created_on": "2026-02-10T13:38:26.158400", "created_on": "2026-02-18T14:56:05.819382",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -168,14 +168,14 @@
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "BOOLEAN",
"type_generic": 3, "type_generic": 3,
"uuid": "6321ba8a-28d7-4d68-a6b3-5cef6cd681a2", "uuid": "6c93e5de-e0d7-430c-88d7-87158905d60a",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158442", "changed_on": "2026-02-18T14:56:05.827568",
"column_name": "is_bot", "column_name": "is_restricted",
"created_on": "2026-02-10T13:38:26.158438", "created_on": "2026-02-18T14:56:05.827556",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -187,14 +187,14 @@
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "BOOLEAN",
"type_generic": 3, "type_generic": 3,
"uuid": "f3ded50e-b1a2-4a88-b805-781d5923e062", "uuid": "2e8e6d32-0124-4e3a-a53f-6f200f852439",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158480", "changed_on": "2026-02-18T14:56:05.835380",
"column_name": "is_owner", "column_name": "is_owner",
"created_on": "2026-02-10T13:38:26.158477", "created_on": "2026-02-18T14:56:05.835366",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -206,14 +206,14 @@
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "BOOLEAN",
"type_generic": 3, "type_generic": 3,
"uuid": "8a1408eb-050d-4455-878c-22342df5da3d", "uuid": "510d651b-a595-4261-98e4-278af0a06594",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158532", "changed_on": "2026-02-18T14:56:05.843802",
"column_name": "is_primary_owner", "column_name": "deleted",
"created_on": "2026-02-10T13:38:26.158528", "created_on": "2026-02-18T14:56:05.843784",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -225,14 +225,14 @@
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "BOOLEAN",
"type_generic": 3, "type_generic": 3,
"uuid": "054b8c16-82fd-480c-82e0-a0975229673a", "uuid": "2653fd2f-c0ce-484e-a5df-d2515b1e822d",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158583", "changed_on": "2026-02-18T14:56:05.851074",
"column_name": "is_restricted", "column_name": "updated",
"created_on": "2026-02-10T13:38:26.158579", "created_on": "2026-02-18T14:56:05.851063",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -240,18 +240,18 @@
"groupby": true, "groupby": true,
"id": 781, "id": 781,
"is_active": true, "is_active": true,
"is_dttm": false, "is_dttm": true,
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "DATETIME",
"type_generic": 3, "type_generic": 2,
"uuid": "6932c25f-0273-4595-85c1-29422a801ded", "uuid": "1b1f90c8-2567-49b8-9398-e7246396461e",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158621", "changed_on": "2026-02-18T14:56:05.857578",
"column_name": "is_ultra_restricted", "column_name": "tz_offset",
"created_on": "2026-02-10T13:38:26.158618", "created_on": "2026-02-18T14:56:05.857571",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -261,16 +261,16 @@
"is_active": true, "is_active": true,
"is_dttm": false, "is_dttm": false,
"python_date_format": null, "python_date_format": null,
"type": "BOOLEAN", "type": "LONGINTEGER",
"type_generic": 3, "type_generic": 0,
"uuid": "9b14e5f9-3ab4-498e-b1e3-bbf49e9d61fe", "uuid": "e6d19b74-7f5d-447b-8071-951961dc2295",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158660", "changed_on": "2026-02-18T14:56:05.863101",
"column_name": "name", "column_name": "channel_name",
"created_on": "2026-02-10T13:38:26.158656", "created_on": "2026-02-18T14:56:05.863094",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -282,14 +282,14 @@
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "STRING",
"type_generic": 1, "type_generic": 1,
"uuid": "ebee8249-0e10-4157-8a8e-96ae107887a3", "uuid": "e1f34628-ebc1-4e0c-8eea-54c3c9efba1b",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158697", "changed_on": "2026-02-18T14:56:05.877136",
"column_name": "real_name", "column_name": "real_name",
"created_on": "2026-02-10T13:38:26.158694", "created_on": "2026-02-18T14:56:05.877083",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -301,14 +301,14 @@
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "STRING",
"type_generic": 1, "type_generic": 1,
"uuid": "553517a0-fe05-4ff5-a4eb-e9d2165d6f64", "uuid": "6cc5ab57-9431-428a-a331-0a5b10e4b074",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158735", "changed_on": "2026-02-18T14:56:05.893859",
"column_name": "team_id", "column_name": "tz_label",
"created_on": "2026-02-10T13:38:26.158731", "created_on": "2026-02-18T14:56:05.893834",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -320,14 +320,14 @@
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "STRING",
"type_generic": 1, "type_generic": 1,
"uuid": "6c207fac-424d-465c-b80a-306b42b55ce8", "uuid": "8e6dbd8e-b880-4517-a5f6-64e429bd1bea",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158773", "changed_on": "2026-02-18T14:56:05.902363",
"column_name": "tz", "column_name": "team_id",
"created_on": "2026-02-10T13:38:26.158769", "created_on": "2026-02-18T14:56:05.902352",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -339,14 +339,14 @@
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "STRING",
"type_generic": 1, "type_generic": 1,
"uuid": "6efcc042-0b78-4362-9373-2f684077d574", "uuid": "ba8e225d-221b-4275-aadb-e79557756f89",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158824", "changed_on": "2026-02-18T14:56:05.910169",
"column_name": "tz_label", "column_name": "name",
"created_on": "2026-02-10T13:38:26.158820", "created_on": "2026-02-18T14:56:05.910151",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -358,14 +358,14 @@
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "STRING",
"type_generic": 1, "type_generic": 1,
"uuid": "c6a6ac40-5c60-472d-a878-4b65b8460ccc", "uuid": "02a7a026-d9f3-49e9-9586-534ebccdd867",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158861", "changed_on": "2026-02-18T14:56:05.915366",
"column_name": "tz_offset", "column_name": "color",
"created_on": "2026-02-10T13:38:26.158857", "created_on": "2026-02-18T14:56:05.915357",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -375,16 +375,16 @@
"is_active": true, "is_active": true,
"is_dttm": false, "is_dttm": false,
"python_date_format": null, "python_date_format": null,
"type": "LONGINTEGER", "type": "STRING",
"type_generic": 0, "type_generic": 1,
"uuid": "cf6da93a-bba9-47df-9154-6cfd0c9922fc", "uuid": "0702fcdf-2d03-45db-8496-697d47b300d6",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158913", "changed_on": "2026-02-18T14:56:05.919466",
"column_name": "updated", "column_name": "id",
"created_on": "2026-02-10T13:38:26.158909", "created_on": "2026-02-18T14:56:05.919460",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -392,18 +392,18 @@
"groupby": true, "groupby": true,
"id": 789, "id": 789,
"is_active": true, "is_active": true,
"is_dttm": true, "is_dttm": false,
"python_date_format": null, "python_date_format": null,
"type": "DATETIME", "type": "STRING",
"type_generic": 2, "type_generic": 1,
"uuid": "2aa0a72a-5602-4799-b5ab-f22000108d62", "uuid": "a4b58528-fcbf-45e9-af39-fe9d737ba380",
"verbose_name": null "verbose_name": null
}, },
{ {
"advanced_data_type": null, "advanced_data_type": null,
"changed_on": "2026-02-10T13:38:26.158967", "changed_on": "2026-02-18T14:56:05.932553",
"column_name": "channel_name", "column_name": "tz",
"created_on": "2026-02-10T13:38:26.158963", "created_on": "2026-02-18T14:56:05.932530",
"description": null, "description": null,
"expression": null, "expression": null,
"extra": null, "extra": null,
@@ -415,7 +415,7 @@
"python_date_format": null, "python_date_format": null,
"type": "STRING", "type": "STRING",
"type_generic": 1, "type_generic": 1,
"uuid": "a84bd658-c83c-4e7f-9e1b-192595092d9b", "uuid": "bc872357-1920-42f3-aeda-b596122bcdb8",
"verbose_name": null "verbose_name": null
} }
], ],
@@ -423,8 +423,8 @@
"first_name": "Superset", "first_name": "Superset",
"last_name": "Admin" "last_name": "Admin"
}, },
"created_on": "2026-02-10T13:38:26.050436", "created_on": "2026-02-18T14:56:04.317950",
"created_on_humanized": "16 days ago", "created_on_humanized": "13 days ago",
"database": { "database": {
"allow_multi_catalog": false, "allow_multi_catalog": false,
"backend": "postgresql", "backend": "postgresql",
@@ -452,8 +452,8 @@
"main_dttm_col": "updated", "main_dttm_col": "updated",
"metrics": [ "metrics": [
{ {
"changed_on": "2026-02-10T13:38:26.182269", "changed_on": "2026-02-18T14:56:05.085244",
"created_on": "2026-02-10T13:38:26.182264", "created_on": "2026-02-18T14:56:05.085166",
"currency": null, "currency": null,
"d3format": null, "d3format": null,
"description": null, "description": null,
@@ -462,7 +462,7 @@
"id": 33, "id": 33,
"metric_name": "count", "metric_name": "count",
"metric_type": "count", "metric_type": "count",
"uuid": "7510f8ca-05ee-4a37-bec1-4a5d7bf2ac50", "uuid": "10c8b8cf-b697-4512-9e9e-2996721f829e",
"verbose_name": "COUNT(*)", "verbose_name": "COUNT(*)",
"warning_text": null "warning_text": null
} }

27
backend/src/services/clean_release/__tests__/test_compliance_orchestrator.py
View File

@@ -48,6 +48,33 @@ def test_orchestrator_stage_failure_blocks_release():
# [/DEF:test_orchestrator_stage_failure_blocks_release:Function] # [/DEF:test_orchestrator_stage_failure_blocks_release:Function]
# [DEF:test_orchestrator_compliant_candidate:Function]
# @PURPOSE: Verify happy path where all mandatory stages pass yields COMPLIANT.
def test_orchestrator_compliant_candidate():
repository = CleanReleaseRepository()
orchestrator = CleanComplianceOrchestrator(repository)
run = orchestrator.start_check_run(
candidate_id="2026.03.03-rc1",
policy_id="policy-enterprise-clean-v1",
triggered_by="tester",
execution_mode="tui",
)
run = orchestrator.execute_stages(
run,
forced_results=[
CheckStageResult(stage=CheckStageName.DATA_PURITY, status=CheckStageStatus.PASS, details="ok"),
CheckStageResult(stage=CheckStageName.INTERNAL_SOURCES_ONLY, status=CheckStageStatus.PASS, details="ok"),
CheckStageResult(stage=CheckStageName.NO_EXTERNAL_ENDPOINTS, status=CheckStageStatus.PASS, details="ok"),
CheckStageResult(stage=CheckStageName.MANIFEST_CONSISTENCY, status=CheckStageStatus.PASS, details="ok"),
],
)
run = orchestrator.finalize_run(run)
assert run.final_status == CheckFinalStatus.COMPLIANT
# [/DEF:test_orchestrator_compliant_candidate:Function]
# [DEF:test_orchestrator_missing_stage_result:Function] # [DEF:test_orchestrator_missing_stage_result:Function]
# @PURPOSE: Verify incomplete mandatory stage set cannot end as COMPLIANT and results in FAILED. # @PURPOSE: Verify incomplete mandatory stage set cannot end as COMPLIANT and results in FAILED.
def test_orchestrator_missing_stage_result(): def test_orchestrator_missing_stage_result():

20
backend/src/services/clean_release/__tests__/test_report_builder.py
View File

@@ -66,6 +66,26 @@ def test_report_builder_blocked_requires_blocking_violations():
# [/DEF:test_report_builder_blocked_requires_blocking_violations:Function] # [/DEF:test_report_builder_blocked_requires_blocking_violations:Function]
# [DEF:test_report_builder_blocked_with_two_violations:Function]
# @PURPOSE: Verify report builder generates conformant payload for a BLOCKED run with violations.
def test_report_builder_blocked_with_two_violations():
builder = ComplianceReportBuilder(CleanReleaseRepository())
run = _terminal_run(CheckFinalStatus.BLOCKED)
v1 = _blocking_violation()
v2 = _blocking_violation()
v2.violation_id = "viol-2"
v2.category = ViolationCategory.DATA_PURITY
report = builder.build_report_payload(run, [v1, v2])
assert report.check_run_id == run.check_run_id
assert report.candidate_id == run.candidate_id
assert report.final_status == CheckFinalStatus.BLOCKED
assert report.violations_count == 2
assert report.blocking_violations_count == 2
# [/DEF:test_report_builder_blocked_with_two_violations:Function]
# [DEF:test_report_builder_counter_consistency:Function] # [DEF:test_report_builder_counter_consistency:Function]
# @PURPOSE: Verify violations counters remain consistent for blocking payload. # @PURPOSE: Verify violations counters remain consistent for blocking payload.
def test_report_builder_counter_consistency(): def test_report_builder_counter_consistency():

21
frontend/src/components/__tests__/task_log_viewer.test.js
View File

@@ -5,6 +5,13 @@
// @LAYER: UI (Tests) // @LAYER: UI (Tests)
// @RELATION: VERIFIES -> frontend/src/components/TaskLogViewer.svelte // @RELATION: VERIFIES -> frontend/src/components/TaskLogViewer.svelte
// @INVARIANT: Duplicate logs are never appended. Polling only active for in-progress tasks. // @INVARIANT: Duplicate logs are never appended. Polling only active for in-progress tasks.
// @TEST_CONTRACT: TaskLogViewerPropsAndLogStream -> RenderedLogTimeline
// @TEST_SCENARIO: historical_and_realtime_merge -> Historical logs render and realtime logs append without duplication.
// @TEST_FIXTURE: valid_viewer -> INLINE_JSON
// @TEST_EDGE: no_task_id -> Null taskId does not trigger fetch.
// @TEST_EDGE: fetch_failure -> Network failure renders recoverable error state with retry action.
// @TEST_EDGE: duplicate_realtime_entry -> Existing log is not duplicated when repeated in realtime stream.
// @TEST_INVARIANT: no_duplicate_log_rows -> VERIFIED_BY: [historical_and_realtime_merge, duplicate_realtime_entry]
import { describe, it, expect, vi, beforeEach } from 'vitest'; import { describe, it, expect, vi, beforeEach } from 'vitest';
import { render, screen, waitFor } from '@testing-library/svelte'; import { render, screen, waitFor } from '@testing-library/svelte';
@@ -15,6 +22,8 @@ vi.mock('../../services/taskService.js', () => ({
getTaskLogs: vi.fn() getTaskLogs: vi.fn()
})); }));
const getTaskLogsMock = vi.mocked(getTaskLogs);
vi.mock('../../lib/i18n', () => ({ vi.mock('../../lib/i18n', () => ({
t: { t: {
subscribe: (fn) => { subscribe: (fn) => {
@@ -39,13 +48,13 @@ describe('TaskLogViewer Component', () => {
}); });
it('renders loading state initially', () => { it('renders loading state initially', () => {
getTaskLogs.mockResolvedValue([]); getTaskLogsMock.mockResolvedValue([]);
render(TaskLogViewer, { inline: true, taskId: 'task-123' }); render(TaskLogViewer, { inline: true, taskId: 'task-123' });
expect(screen.getByText('Loading...')).toBeDefined(); expect(screen.getByText('Loading...')).toBeDefined();
}); });
it('fetches and displays historical logs', async () => { it('fetches and displays historical logs', async () => {
getTaskLogs.mockResolvedValue([ getTaskLogsMock.mockResolvedValue([
{ timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Historical log entry' } { timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Historical log entry' }
]); ]);
@@ -59,7 +68,7 @@ describe('TaskLogViewer Component', () => {
}); });
it('displays error message on fetch failure', async () => { it('displays error message on fetch failure', async () => {
getTaskLogs.mockRejectedValue(new Error('Network error fetching logs')); getTaskLogsMock.mockRejectedValue(new Error('Network error fetching logs'));
render(TaskLogViewer, { inline: true, taskId: 'task-123' }); render(TaskLogViewer, { inline: true, taskId: 'task-123' });
@@ -70,7 +79,7 @@ describe('TaskLogViewer Component', () => {
}); });
it('appends real-time logs passed as props', async () => { it('appends real-time logs passed as props', async () => {
getTaskLogs.mockResolvedValue([ getTaskLogsMock.mockResolvedValue([
{ timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Historical log entry' } { timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Historical log entry' }
]); ]);
@@ -99,7 +108,7 @@ describe('TaskLogViewer Component', () => {
}); });
it('deduplicates real-time logs that are already in historical logs', async () => { it('deduplicates real-time logs that are already in historical logs', async () => {
getTaskLogs.mockResolvedValue([ getTaskLogsMock.mockResolvedValue([
{ timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Duplicate log entry' } { timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Duplicate log entry' }
]); ]);
@@ -132,7 +141,7 @@ describe('TaskLogViewer Component', () => {
// @TEST_FIXTURE valid_viewer // @TEST_FIXTURE valid_viewer
it('fetches and displays historical logs in modal mode under valid_viewer fixture', async () => { it('fetches and displays historical logs in modal mode under valid_viewer fixture', async () => {
getTaskLogs.mockResolvedValue([ getTaskLogsMock.mockResolvedValue([
{ timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Modal log entry' } { timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Modal log entry' }
]); ]);

7
frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js
View File

@@ -5,6 +5,13 @@
// @LAYER: UI Tests // @LAYER: UI Tests
// @RELATION: VERIFIES -> frontend/src/lib/components/assistant/AssistantChatPanel.svelte // @RELATION: VERIFIES -> frontend/src/lib/components/assistant/AssistantChatPanel.svelte
// @INVARIANT: Critical assistant UX states and action hooks remain present in component source. // @INVARIANT: Critical assistant UX states and action hooks remain present in component source.
// @TEST_CONTRACT: AssistantChatSourceArtifacts -> ContractAssertions
// @TEST_SCENARIO: assistant_contract_and_i18n_intact -> Component semantic/UX anchors and locale keys stay consistent.
// @TEST_FIXTURE: assistant_locales_en_ru -> file:src/lib/i18n/locales/en.json + file:src/lib/i18n/locales/ru.json
// @TEST_EDGE: missing_component_anchor -> Missing DEF/UX tags fails contract assertion.
// @TEST_EDGE: missing_action_hook -> Missing confirm/cancel/open_task hooks fails integration assertion.
// @TEST_EDGE: missing_locale_key -> Missing assistant locale key in en/ru fails dictionary assertion.
// @TEST_INVARIANT: assistant_ux_contract_visible -> VERIFIED_BY: [assistant_contract_and_i18n_intact]
import { describe, it, expect } from 'vitest'; import { describe, it, expect } from 'vitest';
import fs from 'node:fs'; import fs from 'node:fs';

17
frontend/src/lib/components/reports/__tests__/report_card.ux.test.js
View File

@@ -8,6 +8,13 @@
// @LAYER: UI // @LAYER: UI
// @RELATION: VERIFIES -> ../ReportCard.svelte // @RELATION: VERIFIES -> ../ReportCard.svelte
// @INVARIANT: Each test asserts at least one observable UX contract outcome. // @INVARIANT: Each test asserts at least one observable UX contract outcome.
// @TEST_CONTRACT: ReportCardInputProps -> ObservableUXOutput
// @TEST_SCENARIO: ready_state_shows_summary_status_type -> Ready state renders summary/status/type labels.
// @TEST_FIXTURE: valid_report_card -> INLINE_JSON
// @TEST_EDGE: empty_report_object -> Missing fields use placeholders and fallback labels.
// @TEST_EDGE: random_status -> Unknown status is rendered without crashing.
// @TEST_EDGE: missing_optional_fields -> Partial report keeps component interactive and emits select.
// @TEST_INVARIANT: report_card_state_is_observable -> VERIFIED_BY: [ready_state_shows_summary_status_type, empty_report_object, random_status]
import { describe, it, expect, vi } from 'vitest'; import { describe, it, expect, vi } from 'vitest';
import { render, screen, fireEvent } from '@testing-library/svelte'; import { render, screen, fireEvent } from '@testing-library/svelte';
@@ -39,7 +46,7 @@ describe('ReportCard UX Contract', () => {
// @UX_STATE: Ready -> Card displays summary/status/type. // @UX_STATE: Ready -> Card displays summary/status/type.
it('should display summary, status and type in Ready state', () => { it('should display summary, status and type in Ready state', () => {
render(ReportCard, { report: mockReport }); render(ReportCard, { report: mockReport, onselect: vi.fn() });
expect(screen.getByText(mockReport.summary)).toBeDefined(); expect(screen.getByText(mockReport.summary)).toBeDefined();
// mockReport.status is "success", getStatusLabel(status) returns $t.reports?.status_success // mockReport.status is "success", getStatusLabel(status) returns $t.reports?.status_success
expect(screen.getByText('Success')).toBeDefined(); expect(screen.getByText('Success')).toBeDefined();
@@ -61,7 +68,7 @@ describe('ReportCard UX Contract', () => {
// @UX_RECOVERY: Missing fields are rendered with explicit placeholder text. // @UX_RECOVERY: Missing fields are rendered with explicit placeholder text.
it('should render placeholders for missing fields', () => { it('should render placeholders for missing fields', () => {
const partialReport = { report_id: 'partial-1' }; const partialReport = { report_id: 'partial-1' };
render(ReportCard, { report: partialReport }); render(ReportCard, { report: partialReport, onselect: vi.fn() });
// Check placeholders (using text from mocked $t) // Check placeholders (using text from mocked $t)
const placeholders = screen.getAllByText('Not provided'); const placeholders = screen.getAllByText('Not provided');
@@ -79,7 +86,7 @@ describe('ReportCard UX Contract', () => {
summary: "Test Summary", summary: "Test Summary",
updated_at: "2024-01-01" updated_at: "2024-01-01"
}; };
render(ReportCard, { report: validReportCard }); render(ReportCard, { report: validReportCard, onselect: vi.fn() });
expect(screen.getByText('Test Summary')).toBeDefined(); expect(screen.getByText('Test Summary')).toBeDefined();
expect(screen.getByText('Success')).toBeDefined(); expect(screen.getByText('Success')).toBeDefined();
@@ -87,14 +94,14 @@ describe('ReportCard UX Contract', () => {
// @TEST_EDGE empty_report_object // @TEST_EDGE empty_report_object
it('should handle completely empty report object gracefully', () => { it('should handle completely empty report object gracefully', () => {
render(ReportCard, { report: {} }); render(ReportCard, { report: {}, onselect: vi.fn() });
const placeholders = screen.getAllByText('Not provided'); const placeholders = screen.getAllByText('Not provided');
expect(placeholders.length).toBeGreaterThan(0); expect(placeholders.length).toBeGreaterThan(0);
}); });
// @TEST_EDGE random_status // @TEST_EDGE random_status
it('should render random status directly if no translation matches', () => { it('should render random status directly if no translation matches', () => {
render(ReportCard, { report: { status: "unknown_status_code" } }); render(ReportCard, { report: { status: "unknown_status_code" }, onselect: vi.fn() });
expect(screen.getByText('unknown_status_code')).toBeDefined(); expect(screen.getByText('unknown_status_code')).toBeDefined();
}); });
}); });

31
generate_semantic_map.py
View File

@@ -189,9 +189,36 @@ class SemanticEntity:
with belief_scope("get_tier"): with belief_scope("get_tier"):
tier_str = self.tags.get("TIER", "STANDARD").upper() tier_str = self.tags.get("TIER", "STANDARD").upper()
try: try:
return Tier(tier_str) base_tier = Tier(tier_str)
except ValueError: except ValueError:
return Tier.STANDARD base_tier = Tier.STANDARD
# Dynamic Tier Adjustments based on User Feedback
# 1. Tests should never be higher than STANDARD
if "test" in self.file_path.lower() or "/__tests__/" in self.file_path or self.name.startswith("test_"):
if base_tier == Tier.CRITICAL:
return Tier.STANDARD
# 2. Svelte components -> TRIVIAL/STANDARD (unless layout/page)
if self.file_path.endswith(".svelte"):
if "+page" not in self.name and "+layout" not in self.name and "Page" not in self.name and "Layout" not in self.name:
if base_tier == Tier.CRITICAL:
return Tier.STANDARD
# 3. Tooling scripts
if "scripts/" in self.file_path or "_tui.py" in self.file_path:
if base_tier == Tier.CRITICAL:
return Tier.STANDARD
# 4. Promote critical security/data paths
critical_keywords = ["auth", "security", "jwt", "database", "migration", "config", "session"]
if any(keyword in self.file_path.lower() for keyword in critical_keywords) and "test" not in self.file_path.lower():
# Allow explicit overrides to lower tiers if explicitly tagged TRIVIAL, otherwise promote logic mapping
if base_tier != Tier.TRIVIAL:
return Tier.CRITICAL
return base_tier
# [/DEF:get_tier:Function] # [/DEF:get_tier:Function]
# [DEF:to_dict:Function] # [DEF:to_dict:Function]

17068
semantics/semantic_map.json
View File

File diff suppressed because it is too large Load Diff

1
specs/023-clean-repo-enterprise/tasks.md
View File

@@ -137,6 +137,7 @@
- [X] T041 Add release checklist artifact template for compliance evidence packaging in `specs/023-clean-repo-enterprise/checklists/release-readiness.md` - [X] T041 Add release checklist artifact template for compliance evidence packaging in `specs/023-clean-repo-enterprise/checklists/release-readiness.md`
- [X] T042 Resolve numeric-prefix governance conflict note (`020-*`) and document decision in `specs/023-clean-repo-enterprise/plan.md` - [X] T042 Resolve numeric-prefix governance conflict note (`020-*`) and document decision in `specs/023-clean-repo-enterprise/plan.md`
- [X] T043 Update feature status traceability and final notes in `specs/023-clean-repo-enterprise/plan.md` - [X] T043 Update feature status traceability and final notes in `specs/023-clean-repo-enterprise/plan.md`
- [X] T044 Remediate CRITICAL semantic test-contract gaps by adding `@TEST_CONTRACT` metadata in backend/frontend flagged modules and recording coverage update in `specs/023-clean-repo-enterprise/tests/coverage.md`
--- ---

5
specs/023-clean-repo-enterprise/tests/coverage.md
View File

@@ -8,6 +8,11 @@
| `clean_release.manifest_builder` | `manifest_builder.py` | STANDARD | ✅ Yes | N/A | N/A | N/A | | `clean_release.manifest_builder` | `manifest_builder.py` | STANDARD | ✅ Yes | N/A | N/A | N/A |
| `clean_release.source_isolation` | `source_isolation.py` | STANDARD | ✅ Yes | N/A | N/A | N/A | | `clean_release.source_isolation` | `source_isolation.py` | STANDARD | ✅ Yes | N/A | N/A | N/A |
| `api.routes.clean_release` | `clean_release.py` | STANDARD | ✅ Yes | N/A | N/A | N/A | | `api.routes.clean_release` | `clean_release.py` | STANDARD | ✅ Yes | N/A | N/A | N/A |
| `api.routes.tasks.get_task_logs` | `tasks.py` | CRITICAL | ✅ Yes | 1/1 | 3/3 | 1/1 |
| `models.clean_release` | `clean_release.py` | CRITICAL | ✅ Yes | 1/1 | 3/3 | 1/1 |
| `frontend.assistant_chat.integration` | `assistant_chat.integration.test.js` | CRITICAL | ✅ Yes | 1/1 | 3/3 | 1/1 |
| `frontend.reports.report_card.ux` | `report_card.ux.test.js` | CRITICAL | ✅ Yes | 1/1 | 3/3 | 1/1 |
| `frontend.task_log_viewer` | `task_log_viewer.test.js` | CRITICAL | ✅ Yes | 1/1 | 3/3 | 1/1 |
## CRITICAL Edge Cases Covered ## CRITICAL Edge Cases Covered

48
specs/023-clean-repo-enterprise/tests/reports/2026-03-04-report.md Normal file
View File

@@ -0,0 +1,48 @@
# Test Report: Global CRITICAL Coverage
Date: 2026-03-04
Executor: GRACE Tester
## Coverage Matrix
| Module | TIER | Tests | Edge Covered | Invariants Covered |
|--------|------|------|----------|------------|
| backend/src/api/routes/tasks.py | CRITICAL | - | - | - |
| backend/src/models/clean_release.py | CRITICAL | - | - | - |
| frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js | CRITICAL | - | - | - |
| frontend/src/lib/components/reports/__tests__/report_card.ux.test.js | CRITICAL | - | - | - |
| frontend/src/components/__tests__/task_log_viewer.test.js | CRITICAL | - | - | - |
*(Note: Matrix focuses only on modules that triggered the fail policy)*
## Contract Validation
- TEST_CONTRACT validated ❌
- All FIXTURES tested ❌
- All EDGES tested ❌
- All INVARIANTS verified ❌
## Results
Total: 0
Passed: 0
Failed: 5
Skipped: 38
## Violations
| Module | Problem | Severity |
|--------|---------|----------|
| `backend/src/api/routes/tasks.py` | [COHERENCE_CHECK_FAILED] Missing TEST_CONTRACT | CRITICAL |
| `backend/src/models/clean_release.py` | [COHERENCE_CHECK_FAILED] Missing TEST_CONTRACT | CRITICAL |
| `frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js` | [COHERENCE_CHECK_FAILED] Missing TEST_CONTRACT | CRITICAL |
| `frontend/src/lib/components/reports/__tests__/report_card.ux.test.js` | [COHERENCE_CHECK_FAILED] Missing TEST_CONTRACT | CRITICAL |
| `frontend/src/components/__tests__/task_log_viewer.test.js` | [COHERENCE_CHECK_FAILED] Missing TEST_CONTRACT | CRITICAL |
## Next Actions
- [ ] Add `@TEST_CONTRACT` to `backend/src/api/routes/tasks.py` (for `get_task_logs` method)
- [ ] Add `@TEST_CONTRACT` to `backend/src/models/clean_release.py`
- [ ] Add `@TEST_CONTRACT` to `frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js` or adjust TIER
- [ ] Add `@TEST_CONTRACT` to `frontend/src/lib/components/reports/__tests__/report_card.ux.test.js` or adjust TIER
- [ ] Add `@TEST_CONTRACT` to `frontend/src/components/__tests__/task_log_viewer.test.js` or adjust TIER