diff --git a/.ai/PERSONA.md b/.ai/PERSONA.md
index 11e5f1e4..27cfcbeb 100644
--- a/.ai/PERSONA.md
+++ b/.ai/PERSONA.md
@@ -2,6 +2,8 @@
 # @COMPLEXITY: 5
 # @SEMANTICS: persona, tone_of_voice, interaction_rules, architect
 # @PURPOSE: Defines how the AI Agent MUST interact with the user and the codebase.
+# @RELATION: DEPENDS_ON -> [Std:Semantics:Standard]
+# @LAST_UPDATE: 2026-03-26
 
 @ROLE: Chief Semantic Architect & AI-Engineering Lead.
 @PHILOSOPHY: "Смысл первичен. Код вторичен. ИИ — это семантический процессор, а не собеседник."
@@ -39,4 +41,4 @@
 
 **Я ожидаю от тебя уровня Senior Staff Engineer, который понимает устройство LLM, KV Cache и графов знаний.**
 
-# [/DEF:Std:UserPersona:Standard]
\ No newline at end of file
+# [/DEF:Std:UserPersona:Standard]
diff --git a/.ai/PROJECT_MAP.md b/.ai/PROJECT_MAP.md
new file mode 100644
index 00000000..f54efe7d
--- /dev/null
+++ b/.ai/PROJECT_MAP.md
@@ -0,0 +1,44 @@
+# [DEF:Project_Map:Root]
+# @COMPLEXITY: 3
+# @PURPOSE: Canonical ownership record for repository structure navigation and generated project-map artifacts.
+# @RELATION: DEPENDS_ON -> [Project_Knowledge_Map:Root]
+# @RELATION: DEPENDS_ON -> [Std:Constitution:Standard]
+# @RELATION: DEPENDS_ON -> [Std:UserPersona:Standard]
+# @RELATION: BINDS_TO -> [MCP_Config:Block]
+# @LAST_UPDATE: 2026-03-26
+
+## Canonical ownership
+- Canonical owner for `Project_Map` is this file: `.ai/PROJECT_MAP.md`.
+- Generated structural snapshot lives at `.ai/structure/PROJECT_MAP.md` and is a backing artifact, not the canonical ownership document.
+- References that previously pointed directly to `.ai/structure/PROJECT_MAP.md` for `Project_Map` should normalize to this file.
+
+## Canonical relations
+- Root knowledge entry: `.ai/ROOT.md` -> `[DEF:Project_Knowledge_Map:Root]`
+- Normalized project MCP configuration: `.kilo/mcp.json` -> `[DEF:MCP_Config:Block]`
+- Repository constitution: `.ai/standards/constitution.md` -> `[DEF:Std:Constitution:Standard]`
+- Repository persona: `.ai/PERSONA.md` -> `[DEF:Std:UserPersona:Standard]`
+
+## Generated snapshot handoff
+- Use `.ai/structure/PROJECT_MAP.md` for the expanded generated module/file inventory.
+- Regeneration may replace snapshot contents without changing canonical ownership of `Project_Map`.
+
+# [DEF:MCP_Config:Block]
+# @COMPLEXITY: 3
+# @PURPOSE: Canonical ownership record for normalized project MCP configuration consumed by semantic workflows.
+# @RELATION: DEPENDS_ON -> [Project_Map:Root]
+# @RELATION: DEPENDS_ON -> [Std:Constitution:Standard]
+# @RELATION: DEPENDS_ON -> [Std:UserPersona:Standard]
+# @LAST_UPDATE: 2026-03-26
+
+## Normalized config path
+- Canonical project MCP config path is `.kilo/mcp.json`.
+- For this repository, new docs and workflows must reference `.kilo/mcp.json` as the normalized MCP config.
+- Do not introduce new canonical references to deprecated project MCP doc paths for ownership or workflow wiring.
+
+## Current semantic workflow binding
+- AXIOM semantic workflows in `.kilocode/workflows/` bind to tools exposed through `.kilo/mcp.json`.
+- The `axiom-core` server definition in `.kilo/mcp.json` is the normalized semantic-audit integration point for this repository.
+
+# [/DEF:MCP_Config:Block]
+
+# [/DEF:Project_Map:Root]
diff --git a/.ai/ROOT.md b/.ai/ROOT.md
index 1ee3ff1a..4a0a88b2 100644
--- a/.ai/ROOT.md
+++ b/.ai/ROOT.md
@@ -1,14 +1,19 @@
 # [DEF:Project_Knowledge_Map:Root]
 # @COMPLEXITY: 5
-# @PURPOSE: Global navigation map for AI-Agent (GRACE Knowledge Graph).
-# @LAST_UPDATE: 2026-02-20
+# @PURPOSE: Canonical GRACE navigation map for repository standards and semantic context.
+# @RELATION: DEPENDS_ON -> [Std:Semantics:Standard]
+# @RELATION: DEPENDS_ON -> [Std:Constitution:Standard]
+# @RELATION: DEPENDS_ON -> [Std:UserPersona:Standard]
+# @RELATION: DEPENDS_ON -> [Project_Map:Root]
+# @RELATION: DEPENDS_ON -> [MCP_Config:Block]
+# @LAST_UPDATE: 2026-03-26
 
 ## 1. SYSTEM STANDARDS (Rules of the Game)
 Strict policies and formatting rules.
 *   **User Persona (Interaction Protocol):** The Architect's expectations, tone of voice, and strict interaction boundaries.
-    *   Ref: `.ai/standards/persona.md` -> `[DEF:Std:UserPersona]`
+    *   Ref: `.ai/PERSONA.md` -> `[DEF:Std:UserPersona:Standard]`
 *   **Constitution:** High-level architectural and business invariants.
-    *   Ref: `.ai/standards/constitution.md` -> `[DEF:Std:Constitution]`
+    *   Ref: `.ai/standards/constitution.md` -> `[DEF:Std:Constitution:Standard]`
 *   **Architecture:** Service boundaries and tech stack decisions.
     *   Ref: `.ai/standards/architecture.md` -> `[DEF:Std:Architecture]`
 *   **Plugin Design:** Rules for building and integrating Plugins.
@@ -18,7 +23,7 @@ Strict policies and formatting rules.
 *   **UI Design:** SvelteKit and Tailwind CSS component standards.
     *   Ref: `.ai/standards/ui_design.md` -> `[DEF:Std:UI_Svelte]`
 *   **Semantic Mapping:** Using `[DEF:]` and belief scopes.
-    *   Ref: `.ai/standards/semantics.md` -> `[DEF:Std:Semantics]`
+    *   Ref: `.ai/standards/semantics.md` -> `[DEF:Std:Semantics:Standard]`
 
 ## 2. FEW-SHOT EXAMPLES (Patterns)
 Use these for code generation (Style Transfer).
@@ -32,8 +37,10 @@ Use these for code generation (Style Transfer).
     *   Ref: `.ai/shots/critical_module.py` -> `[DEF:Shot:Critical_Module]`
 
 ## 3. DOMAIN MAP (Modules)
-*   **High-level Module Map:** `.ai/structure/MODULE_MAP.md` -> `[DEF:Module_Map]`
-*   **Low-level Project Map:** `.ai/structure/PROJECT_MAP.md` -> `[DEF:Project_Map]`
+*   **High-level Module Map:** `.ai/MODULE_MAP.md` -> `[DEF:Module_Map]`
+*   **Canonical Project Map Ownership:** `.ai/PROJECT_MAP.md` -> `[DEF:Project_Map:Root]`
+*   **Generated Project Map Snapshot:** `.ai/structure/PROJECT_MAP.md` (backing generated artifact)
+*   **Normalized MCP Configuration:** `.kilo/mcp.json` -> `[DEF:MCP_Config:Block]`
 *   **Apache Superset OpenAPI Source:** `.ai/openapi/superset_openapi.json` -> `[DEF:Doc:Superset_OpenAPI]`
 *   **Apache Superset OpenAPI Split Index:** `.ai/openapi/superset/README.md` -> `[DEF:Doc:Superset_OpenAPI]`
     *   **Superset OpenAPI Sections:**
@@ -47,4 +54,4 @@ Use these for code generation (Style Transfer).
 *   **Frontend Lib:** `frontend/src/lib` -> `[DEF:Module:Frontend_Lib]`
 *   **Specifications:** `specs/` -> `[DEF:Module:Specs]`
 
-# [/DEF:Project_Knowledge_Map]
+# [/DEF:Project_Knowledge_Map:Root]
diff --git a/.ai/standards/api_design.md b/.ai/standards/api_design.md
index 38b3cb7b..65af288e 100644
--- a/.ai/standards/api_design.md
+++ b/.ai/standards/api_design.md
@@ -44,4 +44,4 @@ async def function_name(...):
 *   Use `try-except` blocks within `belief_scope` to ensure proper error logging and classification.
 *   Do not leak internal implementation details in error responses.
 
-# [/DEF:Std:API_FastAPI]
+# [/DEF:Std:API_FastAPI:Standard]
diff --git a/.ai/standards/architecture.md b/.ai/standards/architecture.md
index 6b3ba2b5..d71dcd37 100644
--- a/.ai/standards/architecture.md
+++ b/.ai/standards/architecture.md
@@ -20,4 +20,4 @@
 *   **Superset API:** Communication via REST API.
 *   **Filesystem:** Local storage for backups and git repositories.
 
-# [/DEF:Std:Architecture]
+# [/DEF:Std:Architecture:Standard]
diff --git a/.ai/standards/constitution.md b/.ai/standards/constitution.md
index 201ac951..09788977 100644
--- a/.ai/standards/constitution.md
+++ b/.ai/standards/constitution.md
@@ -1,14 +1,15 @@
 # [DEF:Std:Constitution:Standard]
 # @COMPLEXITY: 5
 # @PURPOSE: Supreme Law of the Repository. High-level architectural and business invariants.
+# @RELATION: DEPENDS_ON -> [Std:Semantics:Standard]
 # @VERSION: 2.3.0
-# @LAST_UPDATE: 2026-02-19
+# @LAST_UPDATE: 2026-03-26
 # @INVARIANT: Any deviation from this Constitution constitutes a build failure.
 
 ## 1. CORE PRINCIPLES
 
 ### I. Semantic Protocol Compliance
-*   **Ref:** `[DEF:Std:Semantics]` (`ai/standards/semantic.md`)
+*   **Ref:** `[DEF:Std:Semantics:Standard]` (`.ai/standards/semantics.md`)
 *   **Law:** All code must adhere to the Axioms (Meaning First, Contract First, etc.).
 *   **Compliance:** Strict matching of Anchors (`[DEF]`), Tags (`@KEY`), and structures is mandatory.
 
@@ -32,4 +33,4 @@
 *   **Non-Blocking:** API endpoints return Task ID immediately.
 *   **Observability:** Real-time updates via WebSocket.
 
-# [/DEF:Std:Constitution]
+# [/DEF:Std:Constitution:Standard]
diff --git a/.ai/standards/plugin_design.md b/.ai/standards/plugin_design.md
index a31f205c..e4e50699 100644
--- a/.ai/standards/plugin_design.md
+++ b/.ai/standards/plugin_design.md
@@ -29,4 +29,4 @@ Plugins MUST use `TaskContext` for logging to ensure proper source attribution:
 2. **Schema Validation:** Ensure the `get_schema()` precisely matches the `execute()` input expectations.
 3. **Isolation:** Plugins should be self-contained and not depend on other plugins directly. Use core services (`ConfigManager`, `TaskManager`) via dependency injection or the provided `context`.
 
-# [/DEF:Std:Plugin]
+# [/DEF:Std:Plugin:Standard]
diff --git a/.ai/standards/semantics.md b/.ai/standards/semantics.md
index 04bf6235..bc4685f4 100644
--- a/.ai/standards/semantics.md
+++ b/.ai/standards/semantics.md
@@ -1,25 +1,65 @@
-# SYSTEM DIRECTIVE: GRACE-Poly (UX Edition) v2.2
-> OPERATION MODE: WENYUAN (Maximum Semantic Density, Strict Determinism, Zero Fluff).
-> ROLE: AI Software Architect & Implementation Engine (Python/Svelte).
+# [DEF:Std:Semantics:Standard]
+# @COMPLEXITY: 5
+# @PURPOSE: Canonical GRACE protocol for semantic anchors, metadata, relations, and compliance levels.
+# @RELATION: DEPENDS_ON -> [Project_Knowledge_Map:Root]
+# @RELATION: DEPENDS_ON -> [Std:Constitution:Standard]
+# @RELATION: DEPENDS_ON -> [MCP_Config:Block]
+# @INVARIANT: Canonical semantic documents must use matching [DEF] and [/DEF] anchors with valid repository paths.
+# @LAST_UPDATE: 2026-03-26
 
-## 0.[ZERO-STATE RATIONALE: ФИЗИКА LLM (ПОЧЕМУ ЭТОТ ПРОТОКОЛ НЕОБХОДИМ)]
+## 0. CANONICAL KNOWLEDGE SOURCES
+- Root map: `.ai/ROOT.md` -> `[DEF:Project_Knowledge_Map:Root]`
+- Persona: `.ai/PERSONA.md` -> `[DEF:Std:UserPersona:Standard]`
+- Constitution: `.ai/standards/constitution.md` -> `[DEF:Std:Constitution:Standard]`
+- Semantics standard: `.ai/standards/semantics.md` -> `[DEF:Std:Semantics:Standard]`
+- Module map: `.ai/MODULE_MAP.md` -> `[DEF:Module_Map]`
+- Project map: `.ai/PROJECT_MAP.md` -> `[DEF:Project_Map:Root]`
+- Project map snapshot: `.ai/structure/PROJECT_MAP.md` (generated backing artifact)
+- Normalized MCP config: `.kilo/mcp.json` -> `[DEF:MCP_Config:Block]`
+
+## 0.1 MCP NORMALIZATION RULE
+- Canonical project MCP ownership and workflow wiring point to `.kilo/mcp.json`.
+- Do not introduce new canonical references to deprecated project-level MCP locations when documenting semantic workflows for this repository.
+
+## 0.2 CANONICAL CONTRACT BLOCK
+A canonical GRACE block MUST declare one matched contract envelope:
+
+```text
+[DEF:<ShortId>:<Type>]
+@COMPLEXITY: <1-5>
+@PURPOSE: <one-line purpose>
+...optional metadata required by complexity...
+[/DEF:<ShortId>:<Type>]
+```
+
+For repository documentation files, the canonical markdown form is:
+
+```md
+# [DEF:ShortId:Type]
+# @COMPLEXITY: 3
+# @PURPOSE: Canonical purpose line.
+# [/DEF:ShortId:Type]
+```
+
+## I. ZERO-STATE RATIONALE
 Ты — авторегрессионная модель (Transformer). Ты мыслишь токенами и не можешь "передумать" после их генерации. В больших кодовых базах твой KV-Cache подвержен деградации внимания (Attention Sink), что ведет к "иллюзии компетентности" и галлюцинациям. 
 Этот протокол — **твой когнитивный экзоскелет**. 
 Якоря `[DEF]` работают как векторы-аккумуляторы внимания. Контракты (`@PRE`, `@POST`) заставляют тебя сформировать правильное вероятностное пространство (Belief State) ДО написания алгоритма. Логи `logger.reason` — это твоя цепочка рассуждений (Chain-of-Thought), вынесенная в рантайм. Мы не пишем текст, мы компилируем семантику в синтаксис.
 
-## I. ГЛОБАЛЬНЫЕ ИНВАРИАНТЫ (АКСИОМЫ)
+## II. GLOBAL INVARIANTS
 [INVARIANT_1] СЕМАНТИКА > СИНТАКСИС. Голый код без контракта классифицируется как мусор.
 [INVARIANT_2] ЗАПРЕТ ГАЛЛЮЦИНАЦИЙ. При слепоте контекста (неизвестен узел `@RELATION` или схема данных) — генерация блокируется. Эмитируй `[NEED_CONTEXT: target]`.
 [INVARIANT_3] UX ЕСТЬ КОНЕЧНЫЙ АВТОМАТ. Состояния интерфейса — это строгий контракт, а не визуальный декор.
 [INVARIANT_4] ФРАКТАЛЬНЫЙ ЛИМИТ. Длина модуля строго < 300 строк. При превышении — принудительная декомпозиция.
 [INVARIANT_5] НЕПРИКОСНОВЕННОСТЬ ЯКОРЕЙ. Блоки `[DEF]...[/DEF]` используются как аккумуляторы внимания. Закрывающий тег обязателен.
 
-## II. СИНТАКСИС И РАЗМЕТКА (SEMANTIC ANCHORS)
+## III. SYNTAX AND MARKUP (SEMANTIC ANCHORS)
 Формат зависит от среды исполнения:
-- Python: `#[DEF:id:Type] ... # [/DEF:id:Type]`
-- Svelte (HTML/Markup): `<!--[DEF:id:Type] --> ... <!-- [/DEF:id:Type] -->`
-- Svelte (Script/JS): `// [DEF:id:Type] ... //[/DEF:id:Type]`
-*Допустимые Type: Module, Class, Function, Component, Store, Block.*
+- Markdown / docs: `# [DEF:Id:Type] ... # [/DEF:Id:Type]`
+- Python: `# [DEF:Id:Type] ... # [/DEF:Id:Type]`
+- Svelte (HTML/Markup): `<!-- [DEF:Id:Type] --> ... <!-- [/DEF:Id:Type] -->`
+- Svelte (Script/JS/TS): `// [DEF:Id:Type] ... // [/DEF:Id:Type]`
+*Допустимые Type: Root, Standard, Module, Class, Function, Component, Store, Block.*
 
 **Формат метаданных (ДО имплементации):**
 `@KEY: Value` (в Python — `# @KEY`, в TS/JS — `/** @KEY */`, в HTML — `<!-- @KEY -->`).
@@ -28,7 +68,7 @@
 `@RELATION: [PREDICATE] ->[TARGET_ID]`
 *Допустимые предикаты:* DEPENDS_ON, CALLS, INHERITS, IMPLEMENTS, DISPATCHES, BINDS_TO.
 
-## III. ТОПОЛОГИЯ ФАЙЛА (СТРОГИЙ ПОРЯДОК)
+## IV. FILE TOPOLOGY (STRICT ORDER)
 1. **HEADER (Заголовок):**[DEF:filename:Module]
    @COMPLEXITY: [1|2|3|4|5] *(алиас: `@C:`)*
    @SEMANTICS: [keywords]
@@ -39,7 +79,7 @@
 2. **BODY (Тело):** Импорты -> Реализация логики внутри вложенных `[DEF]`.
 3. **FOOTER (Подвал):** [/DEF:filename:Module]
 
-## IV. КОНТРАКТЫ (DESIGN BY CONTRACT & UX)
+## V. CONTRACTS (DESIGN BY CONTRACT & UX)
 Контракты требуются адаптивно по уровню сложности, а не по жесткому tier.
 
 **[CORE CONTRACTS]:**
@@ -62,7 +102,7 @@
 - `@TEST_EDGE: [Название] ->[Сбой]` (Минимум 3: missing_field, invalid_type, external_fail).
 - `@TEST_INVARIANT: [Имя] -> VERIFIED_BY: [scenario_1, ...]`
 
-## V. ШКАЛА СЛОЖНОСТИ (COMPLEXITY 1-5)
+## VI. COMPLEXITY SCALE (1-5)
 Степень контроля задается в Header через `@COMPLEXITY` или сокращение `@C`.
 Если тег отсутствует, сущность по умолчанию считается **Complexity 1**. Это сделано специально для экономии токенов и снижения шума на очевидных утилитах.
 
@@ -93,7 +133,7 @@
   - Использование `belief_scope` строго обязательно.
 
 
-## VI. ПРОТОКОЛ ЛОГИРОВАНИЯ (THREAD-LOCAL BELIEF STATE)
+## VII. LOGGING PROTOCOL (THREAD-LOCAL BELIEF STATE)
 Логирование — это механизм трассировки рассуждений ИИ (CoT) и управления Attention Energy. Архитектура использует Thread-local storage (`_belief_state`), поэтому `ID` прокидывается автоматически.
 
 **[PYTHON CORE TOOLS]:**
@@ -113,7 +153,7 @@
 
 *(Для Frontend/Svelte использовать ручной префикс: `console.info("[ID][REFLECT] Text", {data})`)*
 
-## VII. АЛГОРИТМ ИСПОЛНЕНИЯ И САМОКОРРЕКЦИИ
+## VIII. EXECUTION AND SELF-CORRECTION FLOW
 **[PHASE_1: ANALYSIS]**
 Оцени Complexity, Layer и UX-требования. При слепоте контекста -> `yield [NEED_CONTEXT: id]`.
 **[PHASE_2: SYNTHESIS]**
@@ -129,11 +169,13 @@
 2. ГИПОТЕЗА: Сгенерируй вызов `logger.explore("Ошибка в I/O / Состоянии / Зависимости -> Описание")`.
 3. ЗАПРОС: Запроси разрешение на изменение контракта.
 
-## VIII. ТЕСТЫ: ПРАВИЛА РАЗМЕТКИ
+## IX. TEST MARKUP RULES
 Для предотвращения перегрузки тестовых файлов семантическим шумом и снижения "orphan count" применяются упрощенные правила:
 
 1. **Короткие ID:** Тестовые модули ОБЯЗАНЫ иметь короткие семантические ID (например, `AssistantApiTests`), а не полные пути импорта.
 2. **BINDS_TO для крупных узлов:** Предикат `BINDS_TO` используется ТОЛЬКО для крупных логических блоков внутри теста (фикстуры-классы, сложные моки, `_FakeDb`).
 3. **Complexity 1 для хелперов:** Мелкие вспомогательные функции внутри теста (`_run_async`, `_setup_mock`) остаются на уровне Complexity 1. Для них `@RELATION` и `@PURPOSE` не требуются — достаточно якорей `[DEF]...[/DEF]`.
 4. **Тестовые сценарии:** Сами функции тестов (`test_...`) по умолчанию считаются Complexity 2 (требуется только `@PURPOSE`). Использование `BINDS_TO` для них опционально.
-5. **Запрет на цепочки:** Не нужно описывать граф вызовов внутри теста. Достаточно "заземлить" 1-2 главных хелпера на ID модуля через `BINDS_TO`, чтобы файл перестал считаться набором сирот.
\ No newline at end of file
+5. **Запрет на цепочки:** Не нужно описывать граф вызовов внутри теста. Достаточно "заземлить" 1-2 главных хелпера на ID модуля через `BINDS_TO`, чтобы файл перестал считаться набором сирот.
+
+# [/DEF:Std:Semantics:Standard]
diff --git a/.ai/standards/ui_design.md b/.ai/standards/ui_design.md
index b74087a6..405b2fcd 100644
--- a/.ai/standards/ui_design.md
+++ b/.ai/standards/ui_design.md
@@ -41,8 +41,8 @@ Each Svelte file must follow this structure:
    */
   import { ... } from "...";
   
-  // Exports (Props)
-  export let prop_name = "...";
+  // Props
+  const { prop_name = "..." } = $props();
   
   // Logic
 </script>
@@ -72,4 +72,4 @@ Each Svelte file must follow this structure:
 *   Ensure proper ARIA roles and keyboard navigation for interactive elements.
 *   Use semantic HTML tags (`<nav>`, `<header>`, `<main>`, `<footer>`).
 
-# [/DEF:Std:UI_Svelte]
+# [/DEF:Std:UI_Svelte:Standard]
diff --git a/.ai/structure/MODULE_MAP.md b/.ai/structure/MODULE_MAP.md
new file mode 100644
index 00000000..e3575cc0
--- /dev/null
+++ b/.ai/structure/MODULE_MAP.md
@@ -0,0 +1,5726 @@
+# Module Map
+
+> High-level module structure for AI Context. Generated automatically.
+
+**Generated:** 2026-03-26T13:58:54.333828
+
+## Summary
+
+- **Total Modules:** 316
+- **Total Entities:** 7033
+
+## Module Hierarchy
+
+### 📁 `backend/`
+
+- 🏗️ **Layers:** Utility
+- 📊 **Tiers:** TRIVIAL: 2
+- 📄 **Files:** 1
+- 📦 **Entities:** 2
+
+**Key Entities:**
+
+  - 📦 **DeleteRunningTasksUtil** (Module) `[TRIVIAL]`
+    - Script to delete tasks with RUNNING status from the database...
+
+**Dependencies:**
+
+  - 🔗 DEPENDS_ON -> TaskRecord
+  - 🔗 DEPENDS_ON -> TasksSessionLocal
+
+  ### 📁 `src/`
+
+  - 🏗️ **Layers:** API, Core, UI (API)
+  - 📊 **Tiers:** CRITICAL: 2, STANDARD: 9, TRIVIAL: 18
+  - 📄 **Files:** 3
+  - 📦 **Entities:** 29
+
+  **Key Entities:**
+
+    - 📦 **AppDependencies** (Module)
+      - Manages creation and provision of shared application depende...
+    - 📦 **AppModule** (Module) `[CRITICAL]`
+      - The main entry point for the FastAPI application. It initial...
+    - 📦 **SrcRoot** (Module) `[TRIVIAL]`
+      - Canonical backend package root for application, scripts, and...
+
+  **Dependencies:**
+
+    - 🔗 DEPENDS_ON -> AdminApi
+    - 🔗 DEPENDS_ON -> ApiRoutesModule
+    - 🔗 DEPENDS_ON -> AppDependencies
+    - 🔗 DEPENDS_ON -> AuthApi
+    - 🔗 DEPENDS_ON -> CleanReleaseV2Api
+
+    ### 📁 `api/`
+
+    - 🏗️ **Layers:** API
+    - 📊 **Tiers:** STANDARD: 6, TRIVIAL: 2
+    - 📄 **Files:** 2
+    - 📦 **Entities:** 8
+
+    **Key Entities:**
+
+      - 📦 **AuthApi** (Module)
+        - Authentication API endpoints.
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> AuthService
+      - 🔗 DEPENDS_ON -> fastapi.APIRouter
+      - 🔗 DEPENDS_ON -> get_auth_db
+      - 🔗 DEPENDS_ON -> get_current_user
+      - 🔗 DEPENDS_ON -> is_adfs_configured
+
+      ### 📁 `routes/`
+
+      - 🏗️ **Layers:** API, Infra, UI (API), UI/API
+      - 📊 **Tiers:** CRITICAL: 10, STANDARD: 105, TRIVIAL: 278
+      - 📄 **Files:** 22
+      - 📦 **Entities:** 393
+
+      **Key Entities:**
+
+        - ℂ **ApprovalRequest** (Class) `[TRIVIAL]`
+          - Schema for approval request payload.
+        - ℂ **ApproveMappingRequest** (Class) `[TRIVIAL]`
+          - Optional request DTO for explicit mapping approval audit not...
+        - ℂ **AssistantAction** (Class) `[TRIVIAL]`
+          - UI action descriptor returned with assistant responses.
+        - ℂ **AssistantMessageRequest** (Class) `[TRIVIAL]`
+          - Input payload for assistant message endpoint.
+        - ℂ **AssistantMessageResponse** (Class) `[TRIVIAL]`
+          - Output payload contract for assistant interaction endpoints.
+        - ℂ **BatchApproveMappingRequest** (Class) `[TRIVIAL]`
+          - Request DTO for explicit batch mapping approvals aligned wit...
+        - ℂ **BatchApproveSemanticItemRequest** (Class) `[TRIVIAL]`
+          - Request DTO for one batch semantic-approval item aligned wit...
+        - ℂ **BatchApproveSemanticRequest** (Class) `[TRIVIAL]`
+          - Request DTO for explicit batch semantic approvals inside one...
+        - ℂ **BranchCheckout** (Class) `[TRIVIAL]`
+          - Schema for branch checkout requests.
+        - ℂ **BranchCreate** (Class) `[TRIVIAL]`
+          - Schema for branch creation requests.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> ADGroupMapping:Class
+        - 🔗 DEPENDS_ON -> ApiRoutesModule
+        - 🔗 DEPENDS_ON -> AppConfigRecord
+        - 🔗 DEPENDS_ON -> AppDependencies
+        - 🔗 DEPENDS_ON -> AssistantAuditRecord
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** API, Domain, Domain (Tests), Tests, UI (API Tests)
+        - 📊 **Tiers:** STANDARD: 18, TRIVIAL: 330
+        - 📄 **Files:** 20
+        - 📦 **Entities:** 348
+
+        **Key Entities:**
+
+          - ℂ **DbMock** (Class) `[TRIVIAL]`
+            - In-memory session double for git route tests with minimal qu...
+          - ℂ **MockGitService** (Class) `[TRIVIAL]`
+          - ℂ **MockGitService** (Class) `[TRIVIAL]`
+          - ℂ **MockGitService** (Class) `[TRIVIAL]`
+          - ℂ **MockGitService** (Class) `[TRIVIAL]`
+          - ℂ **MockGitService** (Class) `[TRIVIAL]`
+          - ℂ **SingleConfigDbMock** (Class) `[TRIVIAL]`
+          - ℂ **SingleConfigDbMock** (Class) `[TRIVIAL]`
+          - ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
+            - Provide deterministic environment aliases required by intent...
+          - ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
+            - Deterministic config stub providing hardcoded dev/prod envir...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> ConnectionsRouter
+          - 🔗 DEPENDS_ON -> backend.src.api.routes.assistant
+          - 🔗 DEPENDS_ON -> backend.src.api.routes.clean_release_v2
+          - 🔗 DEPENDS_ON -> backend.src.api.routes.dashboards
+          - 🔗 DEPENDS_ON -> src.api.routes.datasets:Module
+
+    ### 📁 `core/`
+
+    - 🏗️ **Layers:** Core, Domain, Infra
+    - 📊 **Tiers:** CRITICAL: 9, STANDARD: 62, TRIVIAL: 150
+    - 📄 **Files:** 14
+    - 📦 **Entities:** 221
+
+    **Key Entities:**
+
+      - ℂ **AsyncSupersetClient** (Class)
+        - Async sibling of SupersetClient for dashboard read paths.
+      - ℂ **AuthSessionLocal** (Class) `[TRIVIAL]`
+        - A session factory for the authentication database.
+      - ℂ **BeliefFormatter** (Class) `[TRIVIAL]`
+        - Custom logging formatter that adds belief state prefixes to ...
+      - ℂ **ConfigManager** (Class) `[CRITICAL]`
+        - Handles application configuration load, validation, mutation...
+      - ℂ **IdMappingService** (Class) `[CRITICAL]`
+        - Service handling the cataloging and retrieval of remote Supe...
+      - ℂ **LogEntry** (Class) `[TRIVIAL]`
+        - A Pydantic model representing a single, structured log entry...
+      - ℂ **MigrationEngine** (Class) `[CRITICAL]`
+        - Engine for transforming Superset export ZIPs.
+      - ℂ **PluginBase** (Class) `[TRIVIAL]`
+        - Defines the abstract base class that all plugins must implem...
+      - ℂ **PluginConfig** (Class) `[TRIVIAL]`
+        - A Pydantic model used to represent the validated configurati...
+      - ℂ **PluginLoader** (Class)
+        - Scans a specified directory for Python modules, dynamically ...
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> APIClient
+      - 🔗 DEPENDS_ON -> APIClient.__init__
+      - 🔗 DEPENDS_ON -> AppConfig
+      - 🔗 DEPENDS_ON -> AppConfigRecord
+      - 🔗 DEPENDS_ON -> AsyncAPIClient
+
+      ### 📁 `__tests__/`
+
+      - 🏗️ **Layers:** Domain
+      - 📊 **Tiers:** STANDARD: 5, TRIVIAL: 61
+      - 📄 **Files:** 5
+      - 📦 **Entities:** 66
+
+      **Key Entities:**
+
+        - ℂ **_FakeQuery** (Class) `[TRIVIAL]`
+          - Minimal query stub returning hardcoded existing environment ...
+        - ℂ **_FakeSession** (Class) `[TRIVIAL]`
+          - Minimal SQLAlchemy session stub that captures add/delete cal...
+        - ℂ **_FakeSession** (Class) `[TRIVIAL]`
+          - Minimal session stub tracking commit/close signals for confi...
+        - ℂ **_RecordingNetworkClient** (Class) `[TRIVIAL]`
+          - Records request payloads and returns scripted responses for ...
+        - 📦 **NativeFilterExtractionTests** (Module)
+          - Verify native filter extraction from permalinks and native_f...
+        - 📦 **SupersetPreviewPipelineTests** (Module)
+          - Verify explicit chart-data preview compilation and ensure no...
+        - 📦 **TestConfigManagerCompat** (Module)
+          - Verifies ConfigManager compatibility wrappers preserve legac...
+        - 📦 **TestSupersetProfileLookup** (Module)
+          - Verifies Superset profile lookup adapter payload normalizati...
+        - 📦 **test_throttled_scheduler** (Module)
+          - Unit tests for ThrottledSchedulerConfigurator distribution l...
+
+      ### 📁 `auth/`
+
+      - 🏗️ **Layers:** Core, Domain
+      - 📊 **Tiers:** CRITICAL: 3, STANDARD: 2, TRIVIAL: 23
+      - 📄 **Files:** 7
+      - 📦 **Entities:** 28
+
+      **Key Entities:**
+
+        - ℂ **AuthConfig** (Class) `[CRITICAL]`
+          - Holds authentication-related settings.
+        - ℂ **AuthRepository** (Class) `[CRITICAL]`
+          - Initialize repository with database session.
+        - 📦 **AuthConfigModule** (Module) `[TRIVIAL]`
+          - Centralized configuration for authentication and authorizati...
+        - 📦 **AuthJwtModule** (Module)
+          - JWT token generation and validation logic.
+        - 📦 **AuthLoggerModule** (Module)
+          - Audit logging for security-related events.
+        - 📦 **AuthOauthModule** (Module) `[TRIVIAL]`
+          - ADFS OIDC configuration and client using Authlib.
+        - 📦 **AuthRepositoryModule** (Module) `[CRITICAL]`
+          - Data access layer for authentication and user preference ent...
+        - 📦 **AuthSecurityModule** (Module) `[TRIVIAL]`
+          - Utility for password hashing and verification using Passlib.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> ADGroupMapping
+        - 🔗 DEPENDS_ON -> AuthConfig
+        - 🔗 DEPENDS_ON -> OAuth
+        - 🔗 DEPENDS_ON -> Permission
+        - 🔗 DEPENDS_ON -> Role
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Domain
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 14
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 15
+
+        **Key Entities:**
+
+          - 📦 **test_auth** (Module)
+            - Unit tests for authentication module
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Infra
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 11
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 12
+
+        **Key Entities:**
+
+          - 📦 **test_logger** (Module)
+            - Unit tests for logger module
+
+      ### 📁 `migration/`
+
+      - 🏗️ **Layers:** Core, Domain
+      - 📊 **Tiers:** CRITICAL: 3, STANDARD: 2, TRIVIAL: 16
+      - 📄 **Files:** 4
+      - 📦 **Entities:** 21
+
+      **Key Entities:**
+
+        - ℂ **MigrationArchiveParser** (Class) `[CRITICAL]`
+          - Extract normalized dashboards/charts/datasets metadata from ...
+        - ℂ **MigrationDryRunService** (Class) `[CRITICAL]`
+          - Build deterministic diff/risk payload for migration pre-flig...
+        - 📦 **MigrationArchiveParserModule** (Module)
+          - Parse Superset export ZIP archives into normalized object ca...
+        - 📦 **MigrationDryRunOrchestratorModule** (Module)
+          - Compute pre-flight migration diff and risk scoring without a...
+        - 📦 **MigrationPackage** (Module) `[TRIVIAL]`
+          - Namespace package for migration pre-flight orchestration com...
+        - 📦 **RiskAssessorModule** (Module) `[CRITICAL]`
+          - Compute deterministic migration risk items and aggregate sco...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> LoggerModule
+        - 🔗 DEPENDS_ON -> MigrationArchiveParser
+        - 🔗 DEPENDS_ON -> MigrationEngine
+        - 🔗 DEPENDS_ON -> RiskAssessorModule
+        - 🔗 DEPENDS_ON -> SupersetClient
+
+      ### 📁 `task_manager/`
+
+      - 🏗️ **Layers:** Core
+      - 📊 **Tiers:** CRITICAL: 11, STANDARD: 39, TRIVIAL: 33
+      - 📄 **Files:** 7
+      - 📦 **Entities:** 83
+
+      **Key Entities:**
+
+        - ℂ **LogEntry** (Class) `[TRIVIAL]`
+          - A Pydantic model representing a single, structured log entry...
+        - ℂ **LogFilter** (Class) `[TRIVIAL]`
+          - Filter parameters for querying task logs.
+        - ℂ **LogStats** (Class) `[TRIVIAL]`
+          - Statistics about log entries for a task.
+        - ℂ **Task** (Class)
+          - A Pydantic model representing a single execution instance of...
+        - ℂ **TaskCleanupService** (Class)
+          - Provides methods to clean up old task records and their asso...
+        - ℂ **TaskContext** (Class) `[CRITICAL]`
+          - A container passed to plugin.execute() providing the logger ...
+        - ℂ **TaskLog** (Class)
+          - A Pydantic model representing a persisted log entry from the...
+        - ℂ **TaskLogPersistenceService** (Class) `[CRITICAL]`
+          - Provides methods to store, query, summarize, and delete task...
+        - ℂ **TaskLogger** (Class) `[TRIVIAL]`
+          - A wrapper around TaskManager._add_log that carries task_id a...
+        - ℂ **TaskManager** (Class) `[CRITICAL]`
+          - Manages the lifecycle of tasks, including their creation, ex...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> Environment
+        - 🔗 DEPENDS_ON -> EventBus
+        - 🔗 DEPENDS_ON -> JobLifecycle
+        - 🔗 DEPENDS_ON -> LogEntry
+        - 🔗 DEPENDS_ON -> LogFilter
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 10
+        - 📄 **Files:** 2
+        - 📦 **Entities:** 11
+
+        **Key Entities:**
+
+          - 📦 **TestContext** (Module)
+            - Verify TaskContext preserves optional background task schedu...
+          - 📦 **test_task_logger** (Module) `[TRIVIAL]`
+            - Auto-generated module for backend/src/core/task_manager/__te...
+
+      ### 📁 `utils/`
+
+      - 🏗️ **Layers:** Core, Domain, Infra
+      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 26, TRIVIAL: 134
+      - 📄 **Files:** 8
+      - 📦 **Entities:** 161
+
+      **Key Entities:**
+
+        - ℂ **APIClient** (Class)
+          - Synchronous Superset API client with process-local auth toke...
+        - ℂ **AsyncAPIClient** (Class)
+          - Async Superset API client backed by httpx.AsyncClient with s...
+        - ℂ **AuthenticationError** (Class) `[TRIVIAL]`
+          - Exception raised when authentication fails.
+        - ℂ **DashboardNotFoundError** (Class) `[TRIVIAL]`
+          - Exception raised when a dashboard cannot be found.
+        - ℂ **DatasetMapper** (Class) `[TRIVIAL]`
+          - Класс для меппинга и обновления verbose_map в датасетах Supe...
+        - ℂ **InvalidZipFormatError** (Class) `[TRIVIAL]`
+          - Exception raised when a file is not a valid ZIP archive.
+        - ℂ **NetworkError** (Class) `[TRIVIAL]`
+          - Exception raised when a network level error occurs.
+        - ℂ **PermissionDeniedError** (Class) `[TRIVIAL]`
+          - Exception raised when access is denied.
+        - ℂ **PreviewCompilationPayload** (Class) `[TRIVIAL]`
+          - Typed preview payload for Superset-side compilation.
+        - ℂ **SqlLabLaunchPayload** (Class) `[TRIVIAL]`
+          - Typed SQL Lab payload for audited launch handoff.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> AsyncAPIClient.__init__
+        - 🔗 DEPENDS_ON -> AuthenticationError
+        - 🔗 DEPENDS_ON -> CompiledPreview
+        - 🔗 DEPENDS_ON -> DashboardNotFoundError
+        - 🔗 DEPENDS_ON -> Environment
+
+    ### 📁 `models/`
+
+    - 🏗️ **Layers:** Domain, Model, Models
+    - 📊 **Tiers:** CRITICAL: 6, STANDARD: 25, TRIVIAL: 151
+    - 📄 **Files:** 16
+    - 📦 **Entities:** 182
+
+    **Key Entities:**
+
+      - ℂ **ADGroupMapping** (Class) `[CRITICAL]`
+        - Maps an Active Directory group to a local System Role.
+      - ℂ **AnswerKind** (Class) `[TRIVIAL]`
+      - ℂ **AppConfigRecord** (Class) `[CRITICAL]`
+        - Stores persisted application configuration as a single autho...
+      - ℂ **ApprovalDecision** (Class) `[TRIVIAL]`
+        - Approval or rejection bound to a candidate and report.
+      - ℂ **ApprovalState** (Class) `[TRIVIAL]`
+      - ℂ **ArtifactFormat** (Class) `[TRIVIAL]`
+      - ℂ **ArtifactType** (Class) `[TRIVIAL]`
+      - ℂ **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.
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> AuthModels
+      - 🔗 DEPENDS_ON -> Base
+      - 🔗 DEPENDS_ON -> MappingModels
+      - 🔗 DEPENDS_ON -> MappingModels:Base
+      - 🔗 DEPENDS_ON -> Permission
+
+      ### 📁 `__tests__/`
+
+      - 🏗️ **Layers:** Domain
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 39
+      - 📄 **Files:** 3
+      - 📦 **Entities:** 40
+
+      **Key Entities:**
+
+        - 📦 **TestCleanReleaseModels** (Module) `[TRIVIAL]`
+          - Contract testing for Clean Release models
+        - 📦 **test_models** (Module) `[TRIVIAL]`
+          - Unit tests for data models
+        - 📦 **test_report_models** (Module)
+          - Unit tests for report Pydantic models and their validators
+
+    ### 📁 `plugins/`
+
+    - 🏗️ **Layers:** App, Plugin, Plugins
+    - 📊 **Tiers:** CRITICAL: 2, TRIVIAL: 61
+    - 📄 **Files:** 7
+    - 📦 **Entities:** 63
+
+    **Key Entities:**
+
+      - ℂ **BackupPlugin** (Class) `[TRIVIAL]`
+        - Implementation of the backup plugin logic.
+      - ℂ **DebugPlugin** (Class) `[TRIVIAL]`
+        - Plugin for system diagnostics and debugging.
+      - ℂ **GitPlugin** (Class) `[TRIVIAL]`
+        - Реализация плагина Git Integration для управления версиями д...
+      - ℂ **MapperPlugin** (Class) `[TRIVIAL]`
+        - Plugin for mapping dataset columns verbose names.
+      - ℂ **MigrationPlugin** (Class) `[CRITICAL]`
+        - Implementation of the migration plugin workflow and transfor...
+      - ℂ **SearchPlugin** (Class) `[TRIVIAL]`
+        - Plugin for searching text patterns in Superset datasets.
+      - 📦 **BackupPlugin** (Module) `[TRIVIAL]`
+        - A plugin that provides functionality to back up Superset das...
+      - 📦 **DebugPluginModule** (Module) `[TRIVIAL]`
+        - Implements a plugin for system diagnostics and debugging Sup...
+      - 📦 **MapperPluginModule** (Module) `[TRIVIAL]`
+        - Implements a plugin for mapping dataset columns using extern...
+      - 📦 **MigrationPlugin** (Module) `[CRITICAL]`
+        - Orchestrates export, DB-mapping transformation, and import o...
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> IdMappingService
+      - 🔗 DEPENDS_ON -> MigrationEngine
+      - 🔗 DEPENDS_ON -> SupersetClient
+      - 🔗 DEPENDS_ON -> superset_tool.client
+      - 🔗 DEPENDS_ON -> superset_tool.utils
+
+      ### 📁 `git/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 5
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 5
+
+      **Key Entities:**
+
+        - ℂ **GitLLMExtension** (Class) `[TRIVIAL]`
+          - Provides LLM capabilities to the Git plugin.
+        - 📦 **llm_extension** (Module) `[TRIVIAL]`
+          - Auto-generated module for backend/src/plugins/git/llm_extens...
+
+      ### 📁 `llm_analysis/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 67
+      - 📄 **Files:** 4
+      - 📦 **Entities:** 67
+
+      **Key Entities:**
+
+        - ℂ **DashboardValidationPlugin** (Class) `[TRIVIAL]`
+          - Plugin for automated dashboard health analysis using LLMs.
+        - ℂ **DetectedIssue** (Class) `[TRIVIAL]`
+          - Model for a single issue detected during validation.
+        - ℂ **DocumentationPlugin** (Class) `[TRIVIAL]`
+          - Plugin for automated dataset documentation using LLMs.
+        - ℂ **LLMClient** (Class) `[TRIVIAL]`
+          - Wrapper for LLM provider APIs.
+        - ℂ **LLMProviderConfig** (Class) `[TRIVIAL]`
+          - Configuration for an LLM provider.
+        - ℂ **LLMProviderType** (Class) `[TRIVIAL]`
+          - Enum for supported LLM providers.
+        - ℂ **ScreenshotService** (Class) `[TRIVIAL]`
+          - Handles capturing screenshots of Superset dashboards.
+        - ℂ **ValidationResult** (Class) `[TRIVIAL]`
+          - Model for dashboard validation result.
+        - ℂ **ValidationStatus** (Class) `[TRIVIAL]`
+          - Enum for dashboard validation status.
+        - 📦 **plugin** (Module) `[TRIVIAL]`
+          - Auto-generated module for backend/src/plugins/llm_analysis/p...
+
+      **Dependencies:**
+
+        - 🔗 IMPLEMENTS -> backend.src.core.plugin_base.PluginBase
+
+        ### 📁 `__tests__/`
+
+        - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 53
+        - 📄 **Files:** 3
+        - 📦 **Entities:** 56
+
+        **Key Entities:**
+
+          - 📦 **TestClientHeaders** (Module)
+            - Verify OpenRouter client initialization includes provider-sp...
+          - 📦 **TestScreenshotService** (Module)
+            - Protect dashboard screenshot navigation from brittle network...
+          - 📦 **TestService** (Module)
+            - Verify LLM analysis transport/provider failures do not masqu...
+
+      ### 📁 `storage/`
+
+      - 🏗️ **Layers:** App
+      - 📊 **Tiers:** TRIVIAL: 18
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 18
+
+      **Key Entities:**
+
+        - ℂ **StoragePlugin** (Class) `[TRIVIAL]`
+          - Implementation of the storage management plugin.
+        - 📦 **StoragePlugin** (Module) `[TRIVIAL]`
+          - Provides core filesystem operations for managing backups and...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> backend.src.models.storage
+        - 🔗 IMPLEMENTS -> PluginBase
+
+    ### 📁 `schemas/`
+
+    - 🏗️ **Layers:** API, Domain
+    - 📊 **Tiers:** CRITICAL: 9, STANDARD: 13, TRIVIAL: 28
+    - 📄 **Files:** 6
+    - 📦 **Entities:** 50
+
+    **Key Entities:**
+
+      - ℂ **ADGroupMappingCreate** (Class) `[CRITICAL]`
+        - Schema for creating an AD Group mapping.
+      - ℂ **ADGroupMappingSchema** (Class) `[CRITICAL]`
+        - Represents an AD Group to Role mapping in API responses.
+      - ℂ **ClarificationAnswerDto** (Class) `[TRIVIAL]`
+      - ℂ **ClarificationOptionDto** (Class) `[TRIVIAL]`
+      - ℂ **ClarificationQuestionDto** (Class) `[TRIVIAL]`
+      - ℂ **ClarificationSessionDto** (Class) `[TRIVIAL]`
+      - ℂ **CompiledPreviewDto** (Class) `[TRIVIAL]`
+      - ℂ **DashboardHealthItem** (Class) `[TRIVIAL]`
+        - Represents the latest health status of a single dashboard.
+      - ℂ **DatasetProfileDto** (Class) `[TRIVIAL]`
+      - ℂ **DatasetRunContextDto** (Class) `[TRIVIAL]`
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> DatasetReviewModels
+      - 🔗 DEPENDS_ON -> pydantic
+
+      ### 📁 `__tests__/`
+
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 4
+
+      **Key Entities:**
+
+        - 📦 **TestSettingsAndHealthSchemas** (Module)
+          - Regression tests for settings and health schema contracts up...
+
+    ### 📁 `scripts/`
+
+    - 🏗️ **Layers:** Scripts, UI
+    - 📊 **Tiers:** STANDARD: 10, TRIVIAL: 66
+    - 📄 **Files:** 9
+    - 📦 **Entities:** 76
+
+    **Key Entities:**
+
+      - ℂ **CleanReleaseTUI** (Class) `[TRIVIAL]`
+        - Curses-based application for compliance monitoring.
+      - ℂ **TuiFacadeAdapter** (Class) `[TRIVIAL]`
+        - Thin TUI adapter that routes business mutations through appl...
+      - 📦 **CleanReleaseCliScript** (Module)
+        - Provide headless CLI commands for candidate registration, ar...
+      - 📦 **CleanReleaseTuiScript** (Module)
+        - Interactive terminal interface for Enterprise Clean Release ...
+      - 📦 **CreateAdminScript** (Module)
+        - CLI tool for creating the initial admin user.
+      - 📦 **InitAuthDbScript** (Module) `[TRIVIAL]`
+        - Initializes the auth database and creates the necessary tabl...
+      - 📦 **MigrateSqliteToPostgresScript** (Module)
+        - Migrates legacy config and task history from SQLite/file sto...
+      - 📦 **SeedPermissionsScript** (Module)
+        - Populates the auth database with initial system permissions.
+      - 📦 **SeedSupersetLoadTestScript** (Module)
+        - Creates randomized load-test data in Superset by cloning cha...
+      - 📦 **test_dataset_dashboard_relations_script** (Module) `[TRIVIAL]`
+        - Tests and inspects dataset-to-dashboard relationship respons...
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> AuthRepository
+      - 🔗 DEPENDS_ON -> AuthSessionLocal
+      - 🔗 DEPENDS_ON -> INITIAL_PERMISSIONS
+      - 🔗 DEPENDS_ON -> Permission
+      - 🔗 DEPENDS_ON -> Role
+
+    ### 📁 `services/`
+
+    - 🏗️ **Layers:** Core, Domain, Domain/Service, Service
+    - 📊 **Tiers:** CRITICAL: 5, STANDARD: 43, TRIVIAL: 114
+    - 📄 **Files:** 10
+    - 📦 **Entities:** 162
+
+    **Key Entities:**
+
+      - ℂ **AuthService** (Class)
+        - Provides high-level authentication services.
+      - ℂ **EncryptionManager** (Class) `[CRITICAL]`
+        - Handles encryption and decryption of sensitive data like API...
+      - ℂ **EnvironmentNotFoundError** (Class) `[TRIVIAL]`
+        - Raised when environment_id from lookup request is unknown in...
+      - ℂ **GitService** (Class)
+        - Wrapper for GitPython operations with semantic logging and e...
+      - ℂ **HealthService** (Class)
+        - Aggregate latest dashboard validation state and manage persi...
+      - ℂ **LLMProviderService** (Class)
+        - Service to manage LLM provider lifecycle.
+      - ℂ **MappingService** (Class)
+        - Service for handling database mapping logic.
+      - ℂ **ProfileAuthorizationError** (Class) `[TRIVIAL]`
+        - Raised when caller attempts cross-user preference mutation.
+      - ℂ **ProfileService** (Class) `[CRITICAL]`
+        - Implements profile preference read/update flow and Superset ...
+      - ℂ **ProfileValidationError** (Class) `[TRIVIAL]`
+        - Domain validation error for profile preference update reques...
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> AuthRepository
+      - 🔗 DEPENDS_ON -> ConfigManager
+      - 🔗 DEPENDS_ON -> DashboardHealthItem
+      - 🔗 DEPENDS_ON -> EncryptionManager
+      - 🔗 DEPENDS_ON -> GitService
+
+      ### 📁 `__tests__/`
+
+      - 🏗️ **Layers:** Domain, Domain Tests, Service, Service Tests
+      - 📊 **Tiers:** STANDARD: 10, TRIVIAL: 84
+      - 📄 **Files:** 7
+      - 📦 **Entities:** 94
+
+      **Key Entities:**
+
+        - ℂ **TestEncryptionManager** (Class) `[TRIVIAL]`
+          - Validate EncryptionManager encrypt/decrypt roundtrip, unique...
+        - ℂ **_DummyLogger** (Class) `[TRIVIAL]`
+          - Minimal logger shim for TaskContext-like objects used in tes...
+        - ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
+          - Config manager stub providing storage root path and minimal ...
+        - ℂ **_FakeDBSession** (Class) `[TRIVIAL]`
+          - Captures persisted records for assertion and mimics SQLAlche...
+        - ℂ **_FakeLLMClient** (Class) `[TRIVIAL]`
+          - Deterministic LLM client double returning canonical analysis...
+        - ℂ **_FakeNotificationService** (Class) `[TRIVIAL]`
+          - Notification service stub that accepts plugin dispatch_repor...
+        - ℂ **_FakeProviderService** (Class) `[TRIVIAL]`
+          - LLM provider service stub returning deterministic provider a...
+        - ℂ **_FakeScreenshotService** (Class) `[TRIVIAL]`
+          - Screenshot service stub that accepts capture_dashboard calls...
+        - ℂ **_FakeSupersetClient** (Class) `[TRIVIAL]`
+          - Superset client stub exposing network.request as a lambda th...
+        - 📦 **TestResourceService** (Module)
+          - Unit tests for ResourceService
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> backend.src.services.llm_prompt_templates:Function
+        - 🔗 DEPENDS_ON -> pytest:Module
+
+      ### 📁 `clean_release/`
+
+      - 🏗️ **Layers:** Application, Domain, Infra
+      - 📊 **Tiers:** CRITICAL: 9, STANDARD: 13, TRIVIAL: 84
+      - 📄 **Files:** 22
+      - 📦 **Entities:** 106
+
+      **Key Entities:**
+
+        - ℂ **CleanComplianceOrchestrator** (Class) `[TRIVIAL]`
+          - Coordinate clean-release compliance verification stages.
+        - ℂ **CleanPolicyEngine** (Class) `[TRIVIAL]`
+        - ℂ **CleanReleaseRepository** (Class) `[TRIVIAL]`
+          - Data access object for clean release lifecycle.
+        - ℂ **ComplianceExecutionResult** (Class) `[TRIVIAL]`
+          - Return envelope for compliance execution with run/report and...
+        - ℂ **ComplianceExecutionService** (Class) `[TRIVIAL]`
+          - Execute clean-release compliance lifecycle over trusted snap...
+        - 📦 **approval_service** (Module) `[CRITICAL]`
+          - Enforce approval/rejection gates over immutable compliance r...
+        - 📦 **artifact_catalog_loader** (Module)
+          - Load bootstrap artifact catalogs for clean release real-mode...
+        - 📦 **audit_service** (Module)
+          - Provide lightweight audit hooks for clean release preparatio...
+        - 📦 **candidate_service** (Module) `[CRITICAL]`
+          - Register release candidates with validated artifacts and adv...
+        - 📦 **clean_release** (Module)
+          - Redesigned clean release compliance subsystem.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> backend.src.core.config_manager
+        - 🔗 DEPENDS_ON -> backend.src.core.logger
+        - 🔗 DEPENDS_ON -> backend.src.models.clean_release
+        - 🔗 DEPENDS_ON -> backend.src.models.clean_release.CandidateArtifact
+        - 🔗 DEPENDS_ON -> backend.src.models.clean_release.CleanProfilePolicy
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Domain, Infra, Unknown
+        - 📊 **Tiers:** STANDARD: 7, TRIVIAL: 36
+        - 📄 **Files:** 8
+        - 📦 **Entities:** 43
+
+        **Key Entities:**
+
+          - 📦 **TestAuditService** (Module)
+            - Validate audit hooks emit expected log patterns for clean re...
+          - 📦 **TestComplianceOrchestrator** (Module)
+            - Validate compliance orchestrator stage transitions and final...
+          - 📦 **TestManifestBuilder** (Module)
+            - Validate deterministic manifest generation behavior for US1.
+          - 📦 **TestPreparationService** (Module)
+            - Validate release candidate preparation flow, including polic...
+          - 📦 **TestReportBuilder** (Module)
+            - Validate compliance report builder counter integrity and blo...
+          - 📦 **TestSourceIsolation** (Module)
+            - Verify internal source registry validation behavior.
+          - 📦 **TestStages** (Module)
+            - Validate final status derivation logic from stage results.
+          - 📦 **test_policy_engine** (Module) `[TRIVIAL]`
+            - Auto-generated module for backend/src/services/clean_release...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> backend.src.services.clean_release.preparation_service:Module
+
+        ### 📁 `repositories/`
+
+        - 🏗️ **Layers:** Infra
+        - 📊 **Tiers:** STANDARD: 10, TRIVIAL: 46
+        - 📄 **Files:** 10
+        - 📦 **Entities:** 56
+
+        **Key Entities:**
+
+          - 📦 **approval_repository** (Module)
+            - Persist and query approval decisions.
+          - 📦 **artifact_repository** (Module)
+            - Persist and query candidate artifacts.
+          - 📦 **audit_repository** (Module)
+            - Persist and query audit logs for clean release operations.
+          - 📦 **candidate_repository** (Module)
+            - Persist and query release candidates.
+          - 📦 **clean_release_repositories** (Module)
+            - Export all clean release repositories.
+          - 📦 **compliance_repository** (Module)
+            - Persist and query compliance runs, stage runs, and violation...
+          - 📦 **manifest_repository** (Module)
+            - Persist and query distribution manifests.
+          - 📦 **policy_repository** (Module)
+            - Persist and query policy and registry snapshots.
+          - 📦 **publication_repository** (Module)
+            - Persist and query publication records.
+          - 📦 **report_repository** (Module)
+            - Persist and query compliance reports.
+
+        ### 📁 `stages/`
+
+        - 🏗️ **Layers:** Domain
+        - 📊 **Tiers:** STANDARD: 6, TRIVIAL: 18
+        - 📄 **Files:** 6
+        - 📦 **Entities:** 24
+
+        **Key Entities:**
+
+          - ℂ **ComplianceStage** (Class) `[TRIVIAL]`
+            - Protocol for pluggable stage implementations.
+          - ℂ **ComplianceStageContext** (Class) `[TRIVIAL]`
+            - Immutable input envelope passed to each compliance stage.
+          - ℂ **DataPurityStage** (Class) `[TRIVIAL]`
+            - Validate manifest summary for prohibited artifacts.
+          - ℂ **InternalSourcesOnlyStage** (Class) `[TRIVIAL]`
+            - Enforce internal-source-only policy from trusted registry sn...
+          - ℂ **ManifestConsistencyStage** (Class) `[TRIVIAL]`
+            - Validate run/manifest linkage consistency.
+          - ℂ **NoExternalEndpointsStage** (Class) `[TRIVIAL]`
+            - Validate endpoint references from manifest against trusted r...
+          - ℂ **StageExecutionResult** (Class) `[TRIVIAL]`
+            - Structured stage output containing decision, details and vio...
+          - 📦 **base** (Module)
+            - Define shared contracts and helpers for pluggable clean-rele...
+          - 📦 **data_purity** (Module)
+            - Evaluate manifest purity counters and emit blocking violatio...
+          - 📦 **internal_sources_only** (Module)
+            - Verify manifest-declared sources belong to trusted internal ...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> backend.src.models.clean_release
+          - 🔗 DEPENDS_ON -> backend.src.services.clean_release.stages.base
+          - 🔗 IMPLEMENTS -> backend.src.services.clean_release.stages.base.ComplianceStage
+
+      ### 📁 `dataset_review/`
+
+      - 🏗️ **Layers:** Domain, Services
+      - 📊 **Tiers:** CRITICAL: 4, STANDARD: 18, TRIVIAL: 48
+      - 📄 **Files:** 5
+      - 📦 **Entities:** 70
+
+      **Key Entities:**
+
+        - ℂ **ClarificationAnswerCommand** (Class) `[TRIVIAL]`
+          - Typed answer command for clarification state mutation.
+        - ℂ **ClarificationEngine** (Class)
+          - Provide deterministic one-question-at-a-time clarification s...
+        - ℂ **ClarificationQuestionPayload** (Class) `[TRIVIAL]`
+          - Typed active-question payload returned to the API layer.
+        - ℂ **ClarificationStateResult** (Class) `[TRIVIAL]`
+          - Clarification state result carrying the current session, act...
+        - ℂ **DatasetReviewOrchestrator** (Class) `[CRITICAL]`
+          - Coordinate safe session startup while preserving cross-user ...
+        - ℂ **DictionaryResolutionResult** (Class) `[TRIVIAL]`
+          - Carries field-level dictionary resolution output with explic...
+        - ℂ **LaunchDatasetCommand** (Class) `[TRIVIAL]`
+          - Typed input contract for launching one dataset-review sessio...
+        - ℂ **LaunchDatasetResult** (Class) `[TRIVIAL]`
+          - Launch result carrying immutable run context and any gate bl...
+        - ℂ **PreparePreviewCommand** (Class) `[TRIVIAL]`
+          - Typed input contract for compiling one Superset-backed sessi...
+        - ℂ **PreparePreviewResult** (Class) `[TRIVIAL]`
+          - Result contract for one persisted compiled preview attempt.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> ClarificationAnswer
+        - 🔗 DEPENDS_ON -> ClarificationOption
+        - 🔗 DEPENDS_ON -> ClarificationQuestion
+        - 🔗 DEPENDS_ON -> ClarificationSession
+        - 🔗 DEPENDS_ON -> CompiledPreview
+
+        ### 📁 `repositories/`
+
+        - 🏗️ **Layers:** Domain
+        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 11, TRIVIAL: 11
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 23
+
+        **Key Entities:**
+
+          - ℂ **DatasetReviewSessionRepository** (Class)
+            - Enforce ownership-scoped persistence and retrieval for datas...
+          - ℂ **DatasetReviewSessionVersionConflictError** (Class) `[TRIVIAL]`
+            - Signal optimistic-lock conflicts for dataset review session ...
+          - 📦 **DatasetReviewSessionRepository** (Module) `[CRITICAL]`
+            - Persist and retrieve dataset review session aggregates, incl...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> CompiledPreview
+          - 🔗 DEPENDS_ON -> DatasetProfile
+          - 🔗 DEPENDS_ON -> DatasetReviewSession
+          - 🔗 DEPENDS_ON -> DatasetRunContext
+          - 🔗 DEPENDS_ON -> ExecutionMapping
+
+          ### 📁 `__tests__/`
+
+          - 📊 **Tiers:** TRIVIAL: 15
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 15
+
+          **Key Entities:**
+
+            - 📦 **SessionRepositoryTests** (Module) `[TRIVIAL]`
+              - Unit tests for DatasetReviewSessionRepository.
+
+      ### 📁 `notifications/`
+
+      - 🏗️ **Layers:** Domain, Infra
+      - 📊 **Tiers:** CRITICAL: 2, STANDARD: 10, TRIVIAL: 11
+      - 📄 **Files:** 3
+      - 📦 **Entities:** 23
+
+      **Key Entities:**
+
+        - ℂ **NotificationProvider** (Class) `[TRIVIAL]`
+          - Abstract base class for all notification providers.
+        - ℂ **NotificationService** (Class)
+          - Routes validation reports to appropriate users and channels.
+        - ℂ **SMTPProvider** (Class)
+          - Delivers notifications via SMTP.
+        - ℂ **SlackProvider** (Class)
+          - Delivers notifications via Slack Webhooks or API.
+        - ℂ **TelegramProvider** (Class)
+          - Delivers notifications via Telegram Bot API.
+        - 📦 **providers** (Module) `[CRITICAL]`
+          - Defines abstract base and concrete implementations for exter...
+        - 📦 **service** (Module) `[CRITICAL]`
+          - Orchestrates notification routing based on user preferences ...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> NotificationProvider
+        - 🔗 DEPENDS_ON -> SMTPProvider
+        - 🔗 DEPENDS_ON -> SlackProvider
+        - 🔗 DEPENDS_ON -> TelegramProvider
+        - 🔗 DEPENDS_ON -> UserDashboardPreference
+
+        ### 📁 `__tests__/`
+
+        - 📊 **Tiers:** TRIVIAL: 10
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 10
+
+        **Key Entities:**
+
+          - 📦 **test_notification_service** (Module) `[TRIVIAL]`
+            - Unit tests for NotificationService routing and dispatch logi...
+
+      ### 📁 `reports/`
+
+      - 🏗️ **Layers:** Domain
+      - 📊 **Tiers:** CRITICAL: 4, TRIVIAL: 18
+      - 📄 **Files:** 4
+      - 📦 **Entities:** 22
+
+      **Key Entities:**
+
+        - ℂ **ReportsService** (Class) `[CRITICAL]`
+          - Service layer for list/detail report retrieval and normaliza...
+        - 📦 **normalizer** (Module) `[CRITICAL]`
+          - Convert task manager task objects into canonical unified Tas...
+        - 📦 **report_service** (Module) `[CRITICAL]`
+          - Aggregate, normalize, filter, and paginate task reports for ...
+        - 📦 **type_profiles** (Module) `[TRIVIAL]`
+          - Deterministic mapping of plugin/task identifiers to canonica...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> CleanReleaseRepository
+        - 🔗 DEPENDS_ON -> ReportCollection
+        - 🔗 DEPENDS_ON -> ReportDetailView
+        - 🔗 DEPENDS_ON -> ReportQuery
+        - 🔗 DEPENDS_ON -> TaskManager
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Domain, Domain (Tests)
+        - 📊 **Tiers:** TRIVIAL: 26
+        - 📄 **Files:** 3
+        - 📦 **Entities:** 26
+
+        **Key Entities:**
+
+          - 📦 **test_report_normalizer** (Module) `[TRIVIAL]`
+            - Validate unknown task type fallback and partial payload norm...
+          - 📦 **test_report_service** (Module) `[TRIVIAL]`
+            - Unit tests for ReportsService list/detail operations
+
+  ### 📁 `tests/`
+
+  - 🏗️ **Layers:** Core, Domain (Tests), Logging (Tests), Test, Unknown
+  - 📊 **Tiers:** STANDARD: 10, TRIVIAL: 143
+  - 📄 **Files:** 9
+  - 📦 **Entities:** 153
+
+  **Key Entities:**
+
+    - ℂ **TestLogPersistence** (Class)
+      - Test suite for TaskLogPersistenceService.
+    - ℂ **TestTaskPersistenceHelpers** (Class)
+      - Test suite for TaskPersistenceService static helper methods.
+    - ℂ **TestTaskPersistenceService** (Class)
+      - Test suite for TaskPersistenceService CRUD operations.
+    - 📦 **TestAuth** (Module)
+      - Covers authentication service/repository behavior and auth b...
+    - 📦 **TestDashboardsApi** (Module)
+      - Comprehensive contract-driven tests for Dashboard Hub API
+    - 📦 **TestLogger** (Module)
+      - Unit tests for the custom logger formatters and configuratio...
+    - 📦 **TestResourceHubs** (Module)
+      - Contract tests for resource hub dashboards/datasets listing ...
+    - 📦 **test_log_persistence** (Module)
+      - Unit tests for TaskLogPersistenceService.
+    - 📦 **test_smoke_plugins** (Module) `[TRIVIAL]`
+      - Auto-generated module for backend/tests/test_smoke_plugins.p...
+    - 📦 **test_task_manager** (Module)
+      - Unit tests for TaskManager lifecycle, CRUD, log buffering, a...
+
+  **Dependencies:**
+
+    - 🔗 DEPENDS_ON -> DashboardsApi
+    - 🔗 DEPENDS_ON -> DatasetsApi
+
+    ### 📁 `core/`
+
+    - 🏗️ **Layers:** Domain, Unknown
+    - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 50
+    - 📄 **Files:** 4
+    - 📦 **Entities:** 53
+
+    **Key Entities:**
+
+      - ℂ **MockMappingService** (Class) `[TRIVIAL]`
+        - Deterministic mapping service double for native filter ID re...
+      - 📦 **TestGitServiceGiteaPr** (Module)
+        - Validate Gitea PR creation fallback behavior when configured...
+      - 📦 **TestMappingService** (Module)
+        - Unit tests for the IdMappingService matching UUIDs to intege...
+      - 📦 **TestMigrationEngine** (Module)
+        - Unit tests for MigrationEngine's cross-filter patching algor...
+      - 📦 **test_defensive_guards** (Module) `[TRIVIAL]`
+        - Auto-generated module for backend/tests/core/test_defensive_...
+
+      ### 📁 `migration/`
+
+      - 🏗️ **Layers:** Domain
+      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 4
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 6
+
+      **Key Entities:**
+
+        - 📦 **TestArchiveParser** (Module)
+          - Unit tests for MigrationArchiveParser ZIP extraction contrac...
+        - 📦 **TestDryRunOrchestrator** (Module)
+          - Unit tests for MigrationDryRunService diff and risk computat...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> MigrationArchiveParserModule
+        - 🔗 DEPENDS_ON -> MigrationDryRunOrchestratorModule
+
+    ### 📁 `scripts/`
+
+    - 🏗️ **Layers:** Domain, Scripts
+    - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 18
+    - 📄 **Files:** 3
+    - 📦 **Entities:** 21
+
+    **Key Entities:**
+
+      - 📦 **TestCleanReleaseTui** (Module)
+        - Unit tests for the interactive curses TUI of the clean relea...
+      - 📦 **test_clean_release_cli** (Module)
+        - Smoke tests for the redesigned clean release CLI.
+      - 📦 **test_clean_release_tui_v2** (Module)
+        - Smoke tests for thin-client TUI action dispatch and blocked ...
+
+      ### 📁 `clean_release/`
+
+      - 🏗️ **Layers:** Tests
+      - 📊 **Tiers:** STANDARD: 8, TRIVIAL: 51
+      - 📄 **Files:** 8
+      - 📦 **Entities:** 59
+
+      **Key Entities:**
+
+        - ℂ **CleanReleaseCompliancePlugin** (Class) `[TRIVIAL]`
+          - TaskManager plugin shim that executes clean release complian...
+        - ℂ **_PluginLoaderStub** (Class) `[TRIVIAL]`
+          - Provide minimal plugin loader contract used by TaskManager i...
+        - 📦 **TestApprovalService** (Module)
+          - Define approval gate contracts for approve/reject operations...
+        - 📦 **TestComplianceExecutionService** (Module)
+          - Validate stage pipeline and run finalization contracts for c...
+        - 📦 **TestComplianceTaskIntegration** (Module)
+          - Verify clean release compliance runs execute through TaskMan...
+        - 📦 **TestDemoModeIsolation** (Module)
+          - Verify demo and real mode namespace isolation contracts befo...
+        - 📦 **TestPolicyResolutionService** (Module)
+          - Verify trusted policy snapshot resolution contract and error...
+        - 📦 **TestPublicationService** (Module)
+          - Define publication gate contracts over approved candidates a...
+        - 📦 **TestReportAuditImmutability** (Module)
+          - Validate report snapshot immutability expectations and appen...
+        - 📦 **test_candidate_manifest_services** (Module)
+          - Test lifecycle and manifest versioning for release candidate...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> backend.src.services.clean_release.demo_data_service
+        - 🔗 DEPENDS_ON -> clean_release_exceptions
+        - 🔗 DEPENDS_ON -> policy_resolution_service
+        - 🔗 DEPENDS_ON -> repository
+
+      ### 📁 `dataset_review/`
+
+      - 🏗️ **Layers:** Tests
+      - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 2
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 5
+
+      **Key Entities:**
+
+        - 📦 **SupersetCompatibilityMatrixTests** (Module)
+          - Verifies Superset preview and SQL Lab endpoint fallback stra...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> SupersetCompilationAdapter
+        - 🔗 DEPENDS_ON -> backend.src.core.superset_client.SupersetClient
+
+    ### 📁 `components/`
+
+    - 🏗️ **Layers:** Component, Feature, UI, UI -->, Unknown
+    - 📊 **Tiers:** STANDARD: 6, TRIVIAL: 81
+    - 📄 **Files:** 15
+    - 📦 **Entities:** 87
+
+    **Key Entities:**
+
+      - 🧩 **DashboardGrid** (Component)
+        - Displays a grid of dashboards with selection and pagination.
+      - 🧩 **DashboardGrid** (Component)
+        - Displays a grid of dashboards with selection and pagination.
+      - 🧩 **DynamicForm** (Component) `[TRIVIAL]`
+        - Generates a form dynamically based on a JSON schema.
+      - 🧩 **EnvSelector** (Component) `[TRIVIAL]`
+        - Provides a UI component for selecting source and target envi...
+      - 🧩 **Footer** (Component) `[TRIVIAL]`
+        - Displays the application footer with copyright information.
+      - 🧩 **MappingTable** (Component) `[TRIVIAL]`
+        - Displays and allows editing of database mappings.
+      - 🧩 **MissingMappingModal** (Component) `[TRIVIAL]`
+        - Prompts the user to provide a database mapping when one is m...
+      - 🧩 **Navbar** (Component)
+        - Main navigation bar for the application.
+      - 🧩 **PasswordPrompt** (Component) `[TRIVIAL]`
+        - A modal component to prompt the user for database passwords ...
+      - 🧩 **StartupEnvironmentWizard** (Component)
+        - Blocking startup wizard for creating the first Superset envi...
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> LanguageSwitcher
+      - 🔗 DEPENDS_ON -> TaskLogPanel
+
+      ### 📁 `__tests__/`
+
+      - 🏗️ **Layers:** UI (Tests)
+      - 📊 **Tiers:** STANDARD: 1
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 1
+
+      **Key Entities:**
+
+        - 📦 **TaskLogViewerTest** (Module)
+          - Unit tests for TaskLogViewer component by mounting it and ob...
+
+      ### 📁 `auth/`
+
+      - 🏗️ **Layers:** UI
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 3
+
+      **Key Entities:**
+
+        - 🧩 **ProtectedRoute** (Component) `[TRIVIAL]`
+          - Wraps protected slot content with session and permission ver...
+        - 📦 **ProtectedRouteModule** (Module)
+          - Enforces authenticated and authorized access before protecte...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> Permissions
+
+      ### 📁 `git/`
+
+      - 🏗️ **Layers:** Component, Unknown
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 58
+      - 📄 **Files:** 6
+      - 📦 **Entities:** 59
+
+      **Key Entities:**
+
+        - 🧩 **BranchSelector** (Component) `[TRIVIAL]`
+          - UI для выбора и создания веток Git.
+        - 🧩 **CommitHistory** (Component) `[TRIVIAL]`
+          - Displays the commit history for a specific dashboard.
+        - 🧩 **CommitModal** (Component)
+          - Модальное окно для создания коммита с просмотром изменений (...
+        - 🧩 **ConflictResolver** (Component) `[TRIVIAL]`
+          - UI for resolving merge conflicts (Keep Mine / Keep Theirs).
+        - 🧩 **DeploymentModal** (Component) `[TRIVIAL]`
+          - Modal for deploying a dashboard to a target environment.
+        - 🧩 **GitManager** (Component) `[TRIVIAL]`
+          - Центральный UI управления Git с фокусом на рабочий поток ана...
+        - 📦 **GitManager** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/git/GitMan...
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** UI Tests
+        - 📊 **Tiers:** STANDARD: 1
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 1
+
+        **Key Entities:**
+
+          - 📦 **GitManagerUnfinishedMergeIntegrationTest** (Module)
+            - Protect unresolved-merge dialog contract in GitManager pull ...
+
+      ### 📁 `llm/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 12
+      - 📄 **Files:** 3
+      - 📦 **Entities:** 14
+
+      **Key Entities:**
+
+        - 🧩 **DocPreview** (Component)
+          - UI component for previewing generated dataset documentation ...
+        - 🧩 **ProviderConfig** (Component)
+          - UI form for managing LLM provider configurations.
+        - 📦 **DocPreview** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/llm/DocPre...
+        - 📦 **ProviderConfig** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/llm/Provid...
+        - 📦 **ValidationReport** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/llm/Valida...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> backend/src/plugins/llm_analysis/plugin.py
+        - 🔗 DEPENDS_ON -> requestApi
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** UI Tests
+        - 📊 **Tiers:** STANDARD: 2
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 📦 **ProviderConfigIntegrationTest** (Module)
+            - Protect edit and delete interaction contracts in LLM provide...
+
+      ### 📁 `storage/`
+
+      - 🏗️ **Layers:** UI
+      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 6
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 8
+
+      **Key Entities:**
+
+        - 🧩 **FileList** (Component)
+          - Displays a table of files with metadata and actions.
+        - 🧩 **FileUpload** (Component)
+          - Provides a form for uploading files to a specific category.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> storageService
+
+      ### 📁 `tasks/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 13
+      - 📄 **Files:** 4
+      - 📦 **Entities:** 16
+
+      **Key Entities:**
+
+        - 🧩 **LogEntryRow** (Component)
+          - Renders a single log entry with stacked layout optimized for...
+        - 🧩 **LogFilterBar** (Component)
+          - Compact filter toolbar for logs — level, source, and text se...
+        - 🧩 **TaskLogPanel** (Component)
+          - Combines log filtering and display into a single cohesive da...
+        - 📦 **LogFilterBar** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/tasks/LogF...
+        - 📦 **TaskLogPanel** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/tasks/Task...
+        - 📦 **TaskResultPanel** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/tasks/Task...
+
+      ### 📁 `tools/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** TRIVIAL: 16
+      - 📄 **Files:** 4
+      - 📦 **Entities:** 16
+
+      **Key Entities:**
+
+        - 🧩 **ConnectionForm** (Component) `[TRIVIAL]`
+          - UI component for creating a new database connection configur...
+        - 🧩 **ConnectionList** (Component) `[TRIVIAL]`
+          - UI component for listing and deleting saved database connect...
+        - 🧩 **DebugTool** (Component) `[TRIVIAL]`
+          - UI component for system diagnostics and debugging API respon...
+        - 🧩 **MapperTool** (Component) `[TRIVIAL]`
+          - UI component for mapping dataset column verbose names using ...
+        - 📦 **MapperTool** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/components/tools/Mapp...
+
+    ### 📁 `lib/`
+
+    - 🏗️ **Layers:** Infra, Infra-API, UI, UI-State
+    - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 28
+    - 📄 **Files:** 5
+    - 📦 **Entities:** 30
+
+    **Key Entities:**
+
+      - 🧩 **Counter** (Component) `[TRIVIAL]`
+        - Simple counter demo component
+      - 📦 **Utils** (Module) `[TRIVIAL]`
+        - General utility functions (class merging)
+      - 📦 **api_module** (Module)
+        - Handles all communication with the backend API.
+      - 📦 **stores_module** (Module)
+        - Global state management using Svelte stores.
+      - 📦 **toasts_module** (Module) `[TRIVIAL]`
+        - Manages toast notifications using a Svelte writable store.
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> toasts_module
+
+      ### 📁 `api/`
+
+      - 🏗️ **Layers:** Infra, Infra-API
+      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 2, TRIVIAL: 17
+      - 📄 **Files:** 3
+      - 📦 **Entities:** 20
+
+      **Key Entities:**
+
+        - 📦 **AssistantApi** (Module)
+          - API client wrapper for assistant chat, session-scoped prompt...
+        - 📦 **DatasetReviewApi** (Module)
+          - Provide shared frontend helpers for dataset review session-s...
+        - 📦 **ReportsApi** (Module) `[CRITICAL]`
+          - Wrapper-based reports API client for list/detail retrieval w...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> DEF:api_module
+        - 🔗 DEPENDS_ON -> api_module
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Infra (Tests)
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 4
+
+        **Key Entities:**
+
+          - ℂ **TestBuildReportQueryString** (Class) `[TRIVIAL]`
+            - Validate query string construction from filter options.
+          - ℂ **TestGetReportsAsync** (Class) `[TRIVIAL]`
+            - Validate getReports and getReportDetail with mocked api.fetc...
+          - ℂ **TestNormalizeApiError** (Class) `[TRIVIAL]`
+            - Validate error normalization for UI-state mapping.
+          - 📦 **ReportsApiTest** (Module)
+            - Unit tests for reports API client functions: query string bu...
+
+      ### 📁 `auth/`
+
+      - 🏗️ **Layers:** Domain, Feature
+      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 10
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 12
+
+      **Key Entities:**
+
+        - 📦 **Permissions** (Module)
+          - Shared frontend RBAC utilities for route guards and menu vis...
+        - 🗄️ **authStore** (Store)
+          - Manages the global authentication state on the frontend.
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** UI (Tests)
+        - 📊 **Tiers:** STANDARD: 1
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 1
+
+        **Key Entities:**
+
+          - 📦 **PermissionsTest** (Module)
+            - Verifies frontend RBAC permission parsing and access checks.
+
+        ### 📁 `assistant/`
+
+        - 🏗️ **Layers:** UI, UI -->, Unknown
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 37
+        - 📄 **Files:** 2
+        - 📦 **Entities:** 38
+
+        **Key Entities:**
+
+          - 🧩 **AssistantChatPanel** (Component)
+            - Assistant chat workspace for mixed-initiative dataset review...
+          - 🧩 **AssistantClarificationCard** (Component) `[TRIVIAL]`
+            - Render the active dataset-review clarification queue inside ...
+          - 📦 **AssistantChatPanel** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/assist...
+          - 📦 **AssistantClarificationCard** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/assist...
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** UI Tests
+          - 📊 **Tiers:** STANDARD: 4, TRIVIAL: 2
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 6
+
+          **Key Entities:**
+
+            - 📦 **AssistantChatIntegrationTest** (Module)
+              - Contract-level integration checks for assistant chat panel i...
+            - 📦 **AssistantClarificationIntegrationTest** (Module)
+              - Verify AssistantChatPanel hosts the resumable dataset-review...
+            - 📦 **AssistantFirstMessageIntegrationTest** (Module)
+              - Verify first optimistic user message stays visible while a n...
+
+        ### 📁 `dataset-review/`
+
+        - 🏗️ **Layers:** UI -->, Unknown
+        - 📊 **Tiers:** TRIVIAL: 83
+        - 📄 **Files:** 6
+        - 📦 **Entities:** 83
+
+        **Key Entities:**
+
+          - 🧩 **CompiledSQLPreview** (Component) `[TRIVIAL]`
+            - Present the exact Superset-generated compiled SQL preview, e...
+          - 🧩 **ExecutionMappingReview** (Component) `[TRIVIAL]`
+            - Review imported-filter to template-variable mappings, surfac...
+          - 🧩 **LaunchConfirmationPanel** (Component) `[TRIVIAL]`
+            - Summarize final execution context, surface launch blockers e...
+          - 🧩 **SemanticLayerReview** (Component) `[TRIVIAL]`
+            - Surface field-level semantic decisions with provenance, conf...
+          - 🧩 **SourceIntakePanel** (Component) `[TRIVIAL]`
+            - Collect initial dataset source input through Superset link p...
+          - 🧩 **ValidationFindingsPanel** (Component) `[TRIVIAL]`
+            - Present validation findings grouped by severity with explici...
+          - 📦 **CompiledSQLPreview** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/datase...
+          - 📦 **ExecutionMappingReview** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/datase...
+          - 📦 **LaunchConfirmationPanel** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/datase...
+          - 📦 **SemanticLayerReview** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/datase...
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** UI
+          - 📊 **Tiers:** STANDARD: 4
+          - 📄 **Files:** 4
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **DatasetReviewUs2WorkspaceUxTests** (Module)
+              - Verify US2 dataset review surfaces keep semantic review acti...
+            - 📦 **DatasetReviewUs3UxTests** (Module)
+              - Verify US3 mapping review, Superset preview, and launch conf...
+            - 📦 **SourceIntakePanelUxTests** (Module)
+              - Verify source intake entry paths, validation feedback, and s...
+            - 📦 **ValidationFindingsPanelUxTests** (Module)
+              - Verify grouped findings visibility, empty state, and remedia...
+
+        ### 📁 `health/`
+
+        - 🏗️ **Layers:** UI, Unknown
+        - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 6
+        - 📄 **Files:** 2
+        - 📦 **Entities:** 8
+
+        **Key Entities:**
+
+          - 🧩 **HealthMatrix** (Component)
+            - Visual grid summary representing dashboard health status cou...
+          - 🧩 **PolicyForm** (Component)
+            - Form for creating and editing validation policies.
+          - 📦 **PolicyForm** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/health...
+
+        ### 📁 `layout/`
+
+        - 🏗️ **Layers:** UI, Unknown
+        - 📊 **Tiers:** STANDARD: 7, TRIVIAL: 55
+        - 📄 **Files:** 5
+        - 📦 **Entities:** 62
+
+        **Key Entities:**
+
+          - 🧩 **Breadcrumbs** (Component)
+            - Display page hierarchy navigation
+          - 🧩 **Sidebar** (Component)
+            - Persistent left sidebar with resource categories navigation
+          - 🧩 **TaskDrawer** (Component)
+            - Global task drawer for monitoring background operations
+          - 🧩 **TopNavbar** (Component)
+            - Unified top navigation bar with Logo, Search, Activity, and ...
+          - 📦 **Breadcrumbs** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/layout...
+          - 📦 **Sidebar** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/layout...
+          - 📦 **SidebarNavigation** (Module)
+            - Build sidebar navigation categories filtered by current user...
+          - 📦 **TaskDrawer** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/layout...
+          - 📦 **TopNavbar** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/layout...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> Icon
+          - 🔗 DEPENDS_ON -> LanguageSwitcher
+          - 🔗 DEPENDS_ON -> PageStore
+          - 🔗 DEPENDS_ON -> SidebarNavigation
+          - 🔗 DEPENDS_ON -> frontend.src.lib.auth.permissions.hasPermission
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** UI (Tests), Unknown
+          - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 4
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **SidebarNavigationTest** (Module)
+              - Verifies RBAC-based sidebar category and subitem visibility.
+            - 📦 **test_breadcrumbs.svelte** (Module) `[TRIVIAL]`
+              - Auto-generated module for frontend/src/lib/components/layout...
+
+        ### 📁 `reports/`
+
+        - 🏗️ **Layers:** UI, Unknown
+        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 3, TRIVIAL: 11
+        - 📄 **Files:** 4
+        - 📦 **Entities:** 15
+
+        **Key Entities:**
+
+          - 🧩 **ReportCard** (Component)
+            - Render one report with explicit textual type label and profi...
+          - 🧩 **ReportDetailPanel** (Component)
+            - Display detailed report context with diagnostics and actiona...
+          - 🧩 **ReportsList** (Component)
+            - Render unified list of normalized reports with canonical min...
+          - 📦 **ReportCard** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/report...
+          - 📦 **ReportDetailPanel** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/report...
+          - 📦 **ReportTypeProfiles** (Module) `[CRITICAL]`
+            - Deterministic mapping from report task_type to visual profil...
+          - 📦 **ReportsList** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/lib/components/report...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> i18n
+          - 🔗 DEPENDS_ON -> reportTypeProfiles
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** UI, UI (Tests)
+          - 📊 **Tiers:** STANDARD: 7, TRIVIAL: 4
+          - 📄 **Files:** 7
+          - 📦 **Entities:** 11
+
+          **Key Entities:**
+
+            - 📦 **ReportCardTest** (Module)
+              - Test UX states and transitions for ReportCard component
+            - 📦 **ReportDetailIntegrationTest** (Module)
+              - Validate detail-panel behavior for failed reports and recove...
+            - 📦 **ReportDetailUxTest** (Module)
+              - Test UX states and recovery for ReportDetailPanel component
+            - 📦 **ReportTypeProfilesTest** (Module)
+              - Validate report type profile mapping and unknown fallback be...
+            - 📦 **ReportsFilterPerformanceTest** (Module)
+              - Guard test for report filter responsiveness on moderate in-m...
+            - 📦 **ReportsListTest** (Module)
+              - Test ReportsList component iteration and event forwarding.
+            - 📦 **ReportsPageTest** (Module)
+              - Integration-style checks for unified mixed-type reports rend...
+
+          **Dependencies:**
+
+            - 🔗 DEPENDS_ON -> ReportsList
+
+            ### 📁 `fixtures/`
+
+            - 🏗️ **Layers:** UI
+            - 📊 **Tiers:** STANDARD: 1
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 1
+
+            **Key Entities:**
+
+              - 📦 **ReportsFixtures** (Module)
+                - Shared frontend fixtures for unified reports states.
+
+      ### 📁 `i18n/`
+
+      - 🏗️ **Layers:** Infra
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 4
+
+      **Key Entities:**
+
+        - 📦 **i18n** (Module)
+          - Determines the starting locale.
+        - 🗄️ **locale** (Store) `[TRIVIAL]`
+          - Holds the current active locale string.
+        - 🗄️ **t** (Store) `[TRIVIAL]`
+          - Derived store providing the translation dictionary.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> i18n_en_locale
+        - 🔗 DEPENDS_ON -> i18n_ru_locale
+
+      ### 📁 `stores/`
+
+      - 🏗️ **Layers:** UI, UI-State, Unknown
+      - 📊 **Tiers:** STANDARD: 7, TRIVIAL: 44
+      - 📄 **Files:** 7
+      - 📦 **Entities:** 51
+
+      **Key Entities:**
+
+        - 📦 **datasetReviewSession** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/lib/stores/datasetRev...
+        - 📦 **environmentContext** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/lib/stores/environmen...
+        - 📦 **health** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/lib/stores/health.js
+        - 📦 **sidebar** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/lib/stores/sidebar.js
+        - 📦 **taskDrawer** (Module) `[TRIVIAL]`
+          - 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...
+        - 🗄️ **datasetReviewSession** (Store)
+          - Manage active dataset review session state, including loadin...
+        - 🗄️ **environmentContext** (Store)
+          - Global selected environment context for navigation and safet...
+        - 🗄️ **health_store** (Store)
+          - Manage dashboard health summary state and failing counts for...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> api_module
+        - 🔗 DEPENDS_ON -> taskDrawer
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Domain (Tests), UI, UI Tests
+        - 📊 **Tiers:** STANDARD: 8, TRIVIAL: 4
+        - 📄 **Files:** 7
+        - 📦 **Entities:** 12
+
+        **Key Entities:**
+
+          - 📦 **ActivityTest** (Module)
+            - Unit tests for activity store
+          - 📦 **AssistantChatTest** (Module)
+            - Validate assistant chat store visibility and conversation bi...
+          - 📦 **DatasetReviewSessionStoreTests** (Module)
+            - Unit tests for dataset review session store.
+          - 📦 **SidebarIntegrationTest** (Module)
+            - Unit tests for sidebar store
+          - 📦 **SidebarTest** (Module)
+            - Unit tests for sidebar store
+          - 📦 **TaskDrawerTest** (Module)
+            - Unit tests for task drawer store
+          - 📦 **setupTests** (Module)
+            - Global test setup with mocks for SvelteKit modules
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> assistantChatStore
+          - 🔗 DEPENDS_ON -> frontend.src.lib.stores.taskDrawer
+
+          ### 📁 `mocks/`
+
+          - 🏗️ **Layers:** UI (Tests), UI Tests
+          - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 4
+          - 📄 **Files:** 5
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **mock_env_public** (Module)
+              - Mock for $env/static/public SvelteKit module in vitest
+            - 📦 **state_mock** (Module) `[TRIVIAL]`
+              - Mock for AppState in vitest route/component tests.
+
+          **Dependencies:**
+
+            - 🔗 DEPENDS_ON -> $app/navigation
+            - 🔗 DEPENDS_ON -> $app/stores
+
+      ### 📁 `ui/`
+
+      - 🏗️ **Layers:** Atom
+      - 📊 **Tiers:** TRIVIAL: 8
+      - 📄 **Files:** 8
+      - 📦 **Entities:** 8
+
+      **Key Entities:**
+
+        - 🧩 **Button** (Component) `[TRIVIAL]`
+          - Define component interface and default values (Svelte 5 Rune...
+        - 🧩 **Card** (Component) `[TRIVIAL]`
+          - Standardized container with padding and elevation.
+        - 🧩 **Icon** (Component) `[TRIVIAL]`
+          - Render the shared inline SVG icon set with consistent sizing...
+        - 🧩 **Input** (Component) `[TRIVIAL]`
+          - Standardized text input component with label and error handl...
+        - 🧩 **LanguageSwitcher** (Component) `[TRIVIAL]`
+          - Dropdown component to switch between supported languages.
+        - 🧩 **PageHeader** (Component) `[TRIVIAL]`
+          - Standardized page header with title and action area.
+        - 🧩 **Select** (Component) `[TRIVIAL]`
+          - Standardized dropdown selection component.
+        - 📦 **ui** (Module) `[TRIVIAL]`
+          - Central export point for standardized UI components.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> Select
+        - 🔗 DEPENDS_ON -> Utils
+
+      ### 📁 `utils/`
+
+      - 🏗️ **Layers:** Infra
+      - 📊 **Tiers:** TRIVIAL: 2
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 2
+
+      **Key Entities:**
+
+        - 📦 **Debounce** (Module) `[TRIVIAL]`
+          - Debounce utility for limiting function execution rate
+
+    ### 📁 `pages/`
+
+    - 🏗️ **Layers:** UI
+    - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 9
+    - 📄 **Files:** 2
+    - 📦 **Entities:** 11
+
+    **Key Entities:**
+
+      - 🧩 **Dashboard** (Component)
+        - Displays the list of available plugins and allows selecting ...
+      - 🧩 **Settings** (Component)
+        - The main settings page for the application, allowing managem...
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> stores
+      - 🔗 IMPLEMENTS -> PageContracts
+
+    ### 📁 `routes/`
+
+    - 🏗️ **Layers:** Infra, UI, UI (Layout), Unknown
+    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 3, TRIVIAL: 6
+    - 📄 **Files:** 5
+    - 📦 **Entities:** 10
+
+    **Key Entities:**
+
+      - 📦 **+page** (Module) `[TRIVIAL]`
+        - Auto-generated module for frontend/src/routes/+page.svelte
+      - 📦 **RootLayout** (Module)
+        - Root layout component that provides global UI structure (Sid...
+      - 📦 **RootLayoutConfig** (Module) `[TRIVIAL]`
+        - Root layout configuration (SPA mode)
+      - 📦 **layout** (Module)
+        - Bind global layout shell and conditional login/full-app rend...
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> Footer
+      - 🔗 DEPENDS_ON -> ProtectedRoute
+      - 🔗 DEPENDS_ON -> Sidebar
+      - 🔗 DEPENDS_ON -> TaskDrawer
+      - 🔗 DEPENDS_ON -> Toast
+
+        ### 📁 `roles/`
+
+        - 🏗️ **Layers:** Domain
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 5
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 6
+
+        **Key Entities:**
+
+          - 🧩 **AdminRolesPage** (Component)
+            - UI for managing system roles and their permissions.
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> ProtectedRoute
+          - 🔗 DEPENDS_ON -> adminService
+
+        ### 📁 `settings/`
+
+        - 🏗️ **Layers:** Feature
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 4
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 5
+
+        **Key Entities:**
+
+          - 🧩 **AdminSettingsPage** (Component)
+            - UI for configuring Active Directory Group to local Role mapp...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> ProtectedRoute
+          - 🔗 DEPENDS_ON -> adminService
+
+          ### 📁 `llm/`
+
+          - 🏗️ **Layers:** UI, Unknown
+          - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 5
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 6
+
+          **Key Entities:**
+
+            - 🧩 **LLMSettingsPage** (Component)
+              - Admin settings page for LLM provider configuration.
+            - 📦 **+page** (Module) `[TRIVIAL]`
+              - Auto-generated module for frontend/src/routes/admin/settings...
+
+        ### 📁 `users/`
+
+        - 🏗️ **Layers:** Feature
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 5
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 6
+
+        **Key Entities:**
+
+          - 🧩 **AdminUsersPage** (Component)
+            - UI for managing system users and their roles.
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
+          - 🔗 DEPENDS_ON -> frontend.src.services.adminService
+          - 🔗 IMPLEMENTS -> PageContracts
+          - 🔗 IMPLEMENTS -> RoutePages
+
+      ### 📁 `dashboards/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 91
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 92
+
+      **Key Entities:**
+
+        - 📦 **+page** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/routes/dashboards/+pa...
+
+        ### 📁 `[id]/`
+
+        - 🏗️ **Layers:** UI, Unknown
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 28
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 29
+
+        **Key Entities:**
+
+          - 📦 **+page** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/routes/dashboards/[id...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> api_module
+          - 🔗 IMPLEMENTS -> PageContracts
+          - 🔗 IMPLEMENTS -> RoutePages
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** UI (Tests)
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 3
+
+        **Key Entities:**
+
+          - 📦 **DashboardProfileOverrideIntegrationTest** (Module)
+            - Verifies temporary show-all override and restore-on-return b...
+
+        ### 📁 `health/`
+
+        - 🏗️ **Layers:** UI/Page
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 4
+
+        **Key Entities:**
+
+          - 🧩 **HealthCenterPage** (Component)
+            - Main page for the Dashboard Health Center.
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> HealthMatrix
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** UI Tests
+          - 📊 **Tiers:** STANDARD: 1
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 1
+
+          **Key Entities:**
+
+            - 📦 **HealthPageIntegrationTest** (Module)
+              - Lock dashboard health page contract for slug navigation and ...
+
+      ### 📁 `datasets/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 15
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 16
+
+      **Key Entities:**
+
+        - 📦 **+page** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/routes/datasets/+page...
+
+        ### 📁 `[id]/`
+
+        - 🏗️ **Layers:** UI, Unknown
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 6
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 7
+
+        **Key Entities:**
+
+          - 📦 **+page** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/routes/datasets/[id]/...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> api_module
+
+        ### 📁 `review/`
+
+        - 🏗️ **Layers:** UI -->, Unknown
+        - 📊 **Tiers:** TRIVIAL: 14
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 14
+
+        **Key Entities:**
+
+          - 📦 **+page** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/routes/datasets/revie...
+
+          ### 📁 `[id]/`
+
+          - 🏗️ **Layers:** UI -->, Unknown
+          - 📊 **Tiers:** TRIVIAL: 28
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 28
+
+          **Key Entities:**
+
+            - 🧩 **DatasetReviewWorkspace** (Component) `[TRIVIAL]`
+              - Main dataset review workspace coordinating session state thr...
+            - 📦 **+page** (Module) `[TRIVIAL]`
+              - Auto-generated module for frontend/src/routes/datasets/revie...
+
+            ### 📁 `__tests__/`
+
+            - 🏗️ **Layers:** UI
+            - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 3
+
+            **Key Entities:**
+
+              - 📦 **DatasetReviewWorkspaceUxTests** (Module)
+                - Verify the `027` dataset review workspace keeps assistant ch...
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** UI
+          - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 2
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **DatasetReviewEntryUxTests** (Module)
+              - Verify dataset review entry route exposes resumable sessions...
+            - 📦 **DatasetReviewEntryUxTests** (Module)
+              - Verify dataset review entry route exposes resumable sessions...
+
+      ### 📁 `git/`
+
+      - 🏗️ **Layers:** Page
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 3
+
+      **Key Entities:**
+
+        - 🧩 **GitDashboardPage** (Component)
+          - Dashboard management page for Git integration.
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> RepositoryDashboardGrid
+        - 🔗 IMPLEMENTS -> PageContracts
+        - 🔗 IMPLEMENTS -> RoutePages
+
+      ### 📁 `login/`
+
+      - 🏗️ **Layers:** UI
+      - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 3
+
+      **Key Entities:**
+
+        - 🧩 **LoginPage** (Component)
+          - Provides the user interface for local and ADFS authenticatio...
+
+      ### 📁 `migration/`
+
+      - 📊 **Tiers:** TRIVIAL: 21
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 21
+
+      **Key Entities:**
+
+        - 🧩 **DashboardSelectionSection** (Component) `[TRIVIAL]`
+        - 🧩 **MigrationDashboard** (Component) `[TRIVIAL]`
+          - Orchestrate migration UI workflow and route user actions to ...
+
+        ### 📁 `mappings/`
+
+        - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 7
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 8
+
+        **Key Entities:**
+
+          - 🗄️ **UiState** (Store) `[CRITICAL]`
+            - Maintain local page state for environments, fetched database...
+
+      ### 📁 `profile/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 16
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 17
+
+      **Key Entities:**
+
+        - 🧩 **ProfilePage** (Component) `[CRITICAL]`
+          - Manage user profile sections for read-only security access, ...
+        - 📦 **+page** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/routes/profile/+page....
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** UI (Tests)
+        - 📊 **Tiers:** STANDARD: 2
+        - 📄 **Files:** 2
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 📦 **ProfilePreferencesIntegrationTest** (Module)
+            - Verifies profile binding happy path and degraded lookup manu...
+          - 📦 **ProfileSettingsStateIntegrationTest** (Module)
+            - Verifies profile settings preload, cancel without persistenc...
+
+          ### 📁 `fixtures/`
+
+          - 📊 **Tiers:** TRIVIAL: 1
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 1
+
+          **Key Entities:**
+
+            - 📦 **ProfileFixtures** (Module) `[TRIVIAL]`
+              - Shared deterministic fixture inputs for profile page integra...
+
+          **Dependencies:**
+
+            - 🔗 DEPENDS_ON -> frontend/src/lib/i18n/index.ts [key:profile.lookup_error
+            - 🔗 DEPENDS_ON -> i18n.profile.lookup_error
+
+      ### 📁 `reports/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 7
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 8
+
+      **Key Entities:**
+
+        - 🧩 **UnifiedReportsPage** (Component) `[CRITICAL]`
+          - Unified reports page with filtering and resilient UX states ...
+        - 📦 **+page** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/routes/reports/+page....
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> ReportsApi
+        - 🔗 DEPENDS_ON -> ReportsList
+
+          ### 📁 `[taskId]/`
+
+          - 🏗️ **Layers:** UI Tests, Unknown
+          - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 11
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 13
+
+          **Key Entities:**
+
+            - 📦 **+page** (Module) `[TRIVIAL]`
+              - Auto-generated module for frontend/src/routes/reports/llm/[t...
+            - 📦 **ReportPageContractTest** (Module)
+              - Protect the LLM report page from self-triggering screenshot ...
+
+      ### 📁 `settings/`
+
+      - 🏗️ **Layers:** UI, Unknown
+      - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 34
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 35
+
+      **Key Entities:**
+
+        - 📦 **+page** (Module) `[TRIVIAL]`
+          - Auto-generated module for frontend/src/routes/settings/+page...
+
+      **Dependencies:**
+
+        - 🔗 DEPENDS_ON -> sidebar
+
+        ### 📁 `automation/`
+
+        - 🏗️ **Layers:** UI/Page, Unknown
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 7
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 8
+
+        **Key Entities:**
+
+          - 🧩 **AutomationSettingsPage** (Component)
+            - Settings page for managing validation policies.
+          - 📦 **+page** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/routes/settings/autom...
+
+        ### 📁 `connections/`
+
+        - 🏗️ **Layers:** UI
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 1
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 🧩 **ConnectionsSettingsPage** (Component)
+            - Page for managing database connection configurations.
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> ConnectionForm
+          - 🔗 DEPENDS_ON -> ConnectionList
+          - 🔗 IMPLEMENTS -> PageContracts
+          - 🔗 IMPLEMENTS -> RoutePages
+
+        ### 📁 `git/`
+
+        - 🏗️ **Layers:** Page
+        - 📊 **Tiers:** TRIVIAL: 10
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 10
+
+        **Key Entities:**
+
+          - 🧩 **GitSettingsPage** (Component) `[TRIVIAL]`
+            - Manage Git server configurations for dashboard versioning.
+
+        **Dependencies:**
+
+          - 🔗 IMPLEMENTS -> PageContracts
+          - 🔗 IMPLEMENTS -> RoutePages
+
+          ### 📁 `__tests__/`
+
+          - 📊 **Tiers:** TRIVIAL: 1
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 1
+
+          **Key Entities:**
+
+            - 📦 **GitSettingsPageUxTest** (Module) `[TRIVIAL]`
+              - Test UX states and transitions for the Git Settings page
+
+        ### 📁 `notifications/`
+
+        - 🏗️ **Layers:** UI, Unknown
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 4
+
+        **Key Entities:**
+
+          - 🧩 **NotificationSettingsPage** (Component)
+            - Manage global notification provider configurations (SMTP, Te...
+          - 📦 **+page** (Module) `[TRIVIAL]`
+            - Auto-generated module for frontend/src/routes/settings/notif...
+
+      ### 📁 `storage/`
+
+      - 🏗️ **Layers:** Page
+      - 📊 **Tiers:** STANDARD: 1
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 1
+
+      **Dependencies:**
+
+        - 🔗 IMPLEMENTS -> PageContracts
+        - 🔗 IMPLEMENTS -> RoutePages
+
+        ### 📁 `repos/`
+
+        - 🏗️ **Layers:** UI (Page)
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 4
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 5
+
+        **Key Entities:**
+
+          - 📦 **StorageReposPage** (Module)
+            - Dashboard management page for Git integration (moved from /g...
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> RepositoryDashboardGrid
+          - 🔗 DEPENDS_ON -> api
+
+        ### 📁 `debug/`
+
+        - 🏗️ **Layers:** UI
+        - 📊 **Tiers:** STANDARD: 1
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 1
+
+        **Key Entities:**
+
+          - 🧩 **DebugPage** (Component)
+            - Page for system diagnostics and debugging.
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> DebugTool
+          - 🔗 DEPENDS_ON -> TaskRunner
+          - 🔗 IMPLEMENTS -> PageContracts
+          - 🔗 IMPLEMENTS -> RoutePages
+
+        ### 📁 `mapper/`
+
+        - 🏗️ **Layers:** UI
+        - 📊 **Tiers:** STANDARD: 1
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 1
+
+        **Key Entities:**
+
+          - 🧩 **MapperPage** (Component)
+            - Page for the dataset column mapper tool.
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> MapperTool
+          - 🔗 DEPENDS_ON -> TaskRunner
+          - 🔗 IMPLEMENTS -> PageContracts
+          - 🔗 IMPLEMENTS -> RoutePages
+
+        ### 📁 `storage/`
+
+        - 🏗️ **Layers:** UI
+        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 6
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 7
+
+        **Key Entities:**
+
+          - 🧩 **StoragePage** (Component)
+            - Main page for unified file storage management.
+
+        **Dependencies:**
+
+          - 🔗 DEPENDS_ON -> storageService
+
+    ### 📁 `services/`
+
+    - 🏗️ **Layers:** Service
+    - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 33
+    - 📄 **Files:** 6
+    - 📦 **Entities:** 36
+
+    **Key Entities:**
+
+      - 📦 **GitServiceClient** (Module)
+        - API client for Git operations, managing the communication be...
+      - 📦 **adminService** (Module)
+        - Service for Admin-related API calls (User and Role managemen...
+      - 📦 **storageService** (Module)
+        - Frontend API client for file storage management.
+
+    **Dependencies:**
+
+      - 🔗 DEPENDS_ON -> api_module
+      - 🔗 DEPENDS_ON -> specs/011-git-integration-dashboard/contracts/api.md
+
+      ### 📁 `__tests__/`
+
+      - 📊 **Tiers:** TRIVIAL: 1
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 1
+
+      **Key Entities:**
+
+        - 📦 **gitServiceContractTests** (Module) `[TRIVIAL]`
+          - API client tests ensuring correct endpoints are called per c...
+
+    ### 📁 `types/`
+
+    - 🏗️ **Layers:** Domain
+    - 📊 **Tiers:** TRIVIAL: 1
+    - 📄 **Files:** 1
+    - 📦 **Entities:** 1
+
+    **Key Entities:**
+
+      - 📦 **DashboardTypes** (Module) `[TRIVIAL]`
+        - TypeScript interfaces for Dashboard entities
+
+      ### 📁 `scripts/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 10
+      - 📄 **Files:** 2
+      - 📦 **Entities:** 10
+
+      **Key Entities:**
+
+        - 📦 **canonicalize-node-modules** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/nix/scripts/cano...
+        - 📦 **normalize-bun-binaries** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/nix/scripts/norm...
+
+        ### 📁 `e2e/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 46
+        - 📄 **Files:** 3
+        - 📦 **Entities:** 46
+
+        **Key Entities:**
+
+          - 📦 **actions** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/app/e2e...
+          - 📦 **fixtures** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/app/e2e...
+          - 📦 **utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/app/e2e...
+
+          ### 📁 `projects/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 10
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 10
+
+          **Key Entities:**
+
+            - 📦 **projects-switch.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+            - 📦 **workspace-new-session.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+            - 📦 **workspaces.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+
+          ### 📁 `prompt/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 10
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 10
+
+          **Key Entities:**
+
+            - 📦 **context.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+            - 📦 **prompt-history.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+            - 📦 **prompt-slash-share.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+
+          ### 📁 `session/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 10
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 10
+
+          **Key Entities:**
+
+            - 📦 **session-composer-dock.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+            - 📦 **session-undo-redo.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+            - 📦 **session.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+
+          ### 📁 `terminal/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **terminal-tabs.spec** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/e2e...
+
+        ### 📁 `script/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 3
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 3
+
+        **Key Entities:**
+
+          - 📦 **e2e-local** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/app/scr...
+
+          ### 📁 `addons/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 8
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 8
+
+          **Key Entities:**
+
+            - 📦 **serialize** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **serialize.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+
+          ### 📁 `components/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 8
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 8
+
+          **Key Entities:**
+
+            - 📦 **titlebar-history** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **titlebar-history.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+
+            ### 📁 `prompt-input/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 27
+            - 📄 **Files:** 6
+            - 📦 **Entities:** 27
+
+            **Key Entities:**
+
+              - 📦 **attachments** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **build-request-parts** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **editor-dom** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **history** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **placeholder** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **submit** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+
+            ### 📁 `session/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 6
+            - 📄 **Files:** 3
+            - 📦 **Entities:** 6
+
+            **Key Entities:**
+
+              - 📦 **session-context-breakdown** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **session-context-format** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **session-context-metrics** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+
+          ### 📁 `context/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 26
+          - 📄 **Files:** 5
+          - 📦 **Entities:** 26
+
+          **Key Entities:**
+
+            - 📦 **comments.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **layout-scroll** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **model-variant** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **notification-index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **permission-auto-respond** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+
+            ### 📁 `file/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 32
+            - 📄 **Files:** 6
+            - 📦 **Entities:** 32
+
+            **Key Entities:**
+
+              - 📦 **content-cache** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **path** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **tree-store** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **types** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **view-cache** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **watcher** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+
+            ### 📁 `global-sync/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 37
+            - 📄 **Files:** 9
+            - 📦 **Entities:** 37
+
+            **Key Entities:**
+
+              - 📦 **bootstrap** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **child-store** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **event-reducer** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **eviction** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **queue** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **session-cache** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **session-load** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **session-trim** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+              - 📦 **utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+
+          ### 📁 `hooks/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **use-providers** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+
+            ### 📁 `layout/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 4
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 4
+
+            **Key Entities:**
+
+              - 📦 **helpers** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/app/src...
+
+              ### 📁 `composer/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 7
+              - 📄 **Files:** 2
+              - 📦 **Entities:** 7
+
+              **Key Entities:**
+
+                - 📦 **session-composer-state** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/app/src...
+                - 📦 **session-request-tree** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/app/src...
+
+          ### 📁 `utils/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 85
+          - 📄 **Files:** 21
+          - 📦 **Entities:** 85
+
+          **Key Entities:**
+
+            - 📦 **agent** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **aim** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **base64** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **comment-note** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **dom** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **id** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **persist** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **prompt** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **same** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+            - 📦 **scoped-cache** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/app/src...
+
+      ### 📁 `desktop-electron/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 2
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 2
+
+      **Key Entities:**
+
+        - 📦 **electron-builder.config** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/packages/desktop...
+
+        ### 📁 `scripts/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 10
+        - 📄 **Files:** 2
+        - 📦 **Entities:** 10
+
+        **Key Entities:**
+
+          - 📦 **finalize-latest-yml** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/desktop...
+          - 📦 **utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/desktop...
+
+          ### 📁 `main/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 79
+          - 📄 **Files:** 11
+          - 📦 **Entities:** 79
+
+          **Key Entities:**
+
+            - 📦 **apps** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **cli** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **ipc** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **logging** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **markdown** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **menu** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **migrate** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **server** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **store** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+
+          ### 📁 `renderer/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **cli** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+            - 📦 **updater** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+
+            ### 📁 `i18n/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 9
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 9
+
+            **Key Entities:**
+
+              - 📦 **index** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/desktop...
+
+        ### 📁 `scripts/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 4
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 4
+
+        **Key Entities:**
+
+          - 📦 **utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/desktop...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 9
+        - 📄 **Files:** 4
+        - 📦 **Entities:** 9
+
+        **Key Entities:**
+
+          - 📦 **bindings** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/desktop...
+          - 📦 **cli** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/desktop...
+          - 📦 **menu** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/desktop...
+          - 📦 **updater** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/desktop...
+
+          ### 📁 `i18n/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/desktop...
+
+        ### 📁 `__tests__/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 2
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 📦 **previous-docs-redirects.spec** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-do...
+
+          ### 📁 `nodes/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **heading.markdoc** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-do...
+
+          ### 📁 `api/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 7
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 7
+
+          **Key Entities:**
+
+            - 📦 **llms.txt** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-do...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 16
+        - 📄 **Files:** 5
+        - 📦 **Entities:** 16
+
+        **Key Entities:**
+
+          - 📦 **cloud-sessions** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-ga...
+          - 📦 **headers** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-ga...
+          - 📦 **loader** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-ga...
+          - 📦 **provider** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-ga...
+          - 📦 **provider-debug** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-ga...
+
+          ### 📁 `api/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 14
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 14
+
+          **Key Entities:**
+
+            - 📦 **models** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+            - 📦 **notifications** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+            - 📦 **profile** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+
+          ### 📁 `auth/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 18
+          - 📄 **Files:** 5
+          - 📦 **Entities:** 18
+
+          **Key Entities:**
+
+            - 📦 **device-auth** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+            - 📦 **device-auth-tui** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+            - 📦 **legacy-migration** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+            - 📦 **polling** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+            - 📦 **token** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+
+          ### 📁 `server/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **routes** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+
+          ### 📁 `tui/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 8
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 8
+
+          **Key Entities:**
+
+            - 📦 **context** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+            - 📦 **helpers** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+
+          ### 📁 `types/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 6
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 6
+
+          **Key Entities:**
+
+            - 📦 **tui.d** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ga...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 48
+        - 📄 **Files:** 4
+        - 📦 **Entities:** 48
+
+        **Key Entities:**
+
+          - 📦 **client** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-te...
+          - 📦 **identity** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-te...
+          - 📦 **telemetry** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-te...
+          - 📦 **tracer** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-te...
+
+          ### 📁 `__tests__/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 3
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 3
+
+          **Key Entities:**
+
+            - 📦 **telemetry.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-te...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 3
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 3
+
+        **Key Entities:**
+
+          - 📦 **file-path** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-ui...
+
+          ### 📁 `components/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **tool-utils** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-ui...
+
+        ### 📁 `tests/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 7
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 7
+
+        **Key Entities:**
+
+          - 📦 **visual-regression.spec** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-ui...
+
+      ### 📁 `kilo-vscode/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 6
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 6
+
+      **Key Entities:**
+
+        - 📦 **esbuild** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+        ### 📁 `script/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 21
+        - 📄 **Files:** 3
+        - 📦 **Entities:** 21
+
+        **Key Entities:**
+
+          - 📦 **launch** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **local-bin** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **watch-cli** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 61
+        - 📄 **Files:** 10
+        - 📦 **Entities:** 61
+
+        **Key Entities:**
+
+          - 📦 **extension** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **image-preview** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **kilo-provider-utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **path-utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **project-directory** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **provider-actions** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **review-utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **session-status** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **webview-html-utils** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+          ### 📁 `agent-manager/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 52
+          - 📄 **Files:** 14
+          - 📦 **Entities:** 52
+
+          **Key Entities:**
+
+            - 📦 **SetupScriptRunner** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **WorktreeManager** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **WorktreeStateManager** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **base-branch** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **branch-name** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **constants** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **delete-worktree** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **fork-session** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **format-keybinding** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **git-import** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `__tests__/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 8
+            - 📄 **Files:** 2
+            - 📦 **Entities:** 8
+
+            **Key Entities:**
+
+              - 📦 **AgentManagerProvider.spec** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **SetupScriptService.spec** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+          ### 📁 `commands/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 3
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 3
+
+          **Key Entities:**
+
+            - 📦 **toggle-auto-approve** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+          ### 📁 `kilo-provider/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **slim-metadata** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `handlers/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 21
+            - 📄 **Files:** 5
+            - 📦 **Entities:** 21
+
+            **Key Entities:**
+
+              - 📦 **auth** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **cloud-session** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **migration** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **permission-handler** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **question** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+          ### 📁 `legacy-migration/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 27
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 27
+
+          **Key Entities:**
+
+            - 📦 **migration-service** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `autocomplete/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 9
+            - 📄 **Files:** 3
+            - 📦 **Entities:** 9
+
+            **Key Entities:**
+
+              - 📦 **AutocompleteServiceManager** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **statusbar-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **types** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `__tests__/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 6
+              - 📄 **Files:** 3
+              - 📦 **Entities:** 6
+
+              **Key Entities:**
+
+                - 📦 **AutocompleteModel.spec** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **AutocompleteServiceManager.spec** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **MockWorkspaceEdit** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `chat-autocomplete/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 8
+              - 📄 **Files:** 3
+              - 📦 **Entities:** 8
+
+              **Key Entities:**
+
+                - 📦 **chat-autocomplete-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **handleChatCompletionAccepted** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **handleChatCompletionRequest** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `classic-auto-complete/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 43
+              - 📄 **Files:** 9
+              - 📦 **Entities:** 43
+
+              **Key Entities:**
+
+                - 📦 **AutocompleteInlineCompletionProvider** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **AutocompleteTelemetry** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **HoleFiller** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **contextualSkip** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **getProcessedSnippets** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **hole-filler-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **inline-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **telemetry-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **uselessSuggestionFilter** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                ### 📁 `__tests__/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 8
+                - 📄 **Files:** 4
+                - 📦 **Entities:** 8
+
+                **Key Entities:**
+
+                  - 📦 **AutocompleteContextProvider.test** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/kilo-vs...
+                  - 📦 **AutocompleteInlineCompletionProvider.test** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/kilo-vs...
+                  - 📦 **AutocompleteTelemetry.test** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/kilo-vs...
+                  - 📦 **HoleFiller.test** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                ### 📁 `language-filters/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 6
+                - 📄 **Files:** 2
+                - 📦 **Entities:** 6
+
+                **Key Entities:**
+
+                  - 📦 **index** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/kilo-vs...
+                  - 📦 **markdown** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `context/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 4
+              - 📄 **Files:** 2
+              - 📦 **Entities:** 4
+
+              **Key Entities:**
+
+                - 📦 **VisibleCodeTracker** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **visible-code-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `classification/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 3
+                    - 📄 **Files:** 1
+                    - 📦 **Entities:** 3
+
+                    **Key Entities:**
+
+                      - 📦 **shouldCompleteMultiline** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `constants/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 3
+                    - 📄 **Files:** 1
+                    - 📦 **Entities:** 3
+
+                    **Key Entities:**
+
+                      - 📦 **AutocompleteLanguageInfo** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                      ### 📁 `ranking/`
+
+                      - 🏗️ **Layers:** Unknown
+                      - 📊 **Tiers:** TRIVIAL: 8
+                      - 📄 **Files:** 1
+                      - 📦 **Entities:** 8
+
+                      **Key Entities:**
+
+                        - 📦 **index** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                      ### 📁 `root-path-context/`
+
+                      - 🏗️ **Layers:** Unknown
+                      - 📊 **Tiers:** TRIVIAL: 3
+                      - 📄 **Files:** 1
+                      - 📦 **Entities:** 3
+
+                      **Key Entities:**
+
+                        - 📦 **testUtils** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                          ### 📁 `files/`
+
+                          - 🏗️ **Layers:** Unknown
+                          - 📊 **Tiers:** TRIVIAL: 7
+                          - 📄 **Files:** 1
+                          - 📦 **Entities:** 7
+
+                          **Key Entities:**
+
+                            - 📦 **base_module** (Module) `[TRIVIAL]`
+                              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                            ### 📁 `python/`
+
+                            - 🏗️ **Layers:** Unknown
+                            - 📊 **Tiers:** TRIVIAL: 10
+                            - 📄 **Files:** 1
+                            - 📦 **Entities:** 10
+
+                            **Key Entities:**
+
+                              - 📦 **functions** (Module) `[TRIVIAL]`
+                                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                            ### 📁 `typescript/`
+
+                            - 🏗️ **Layers:** Unknown
+                            - 📊 **Tiers:** TRIVIAL: 9
+                            - 📄 **Files:** 1
+                            - 📦 **Entities:** 9
+
+                            **Key Entities:**
+
+                              - 📦 **functions** (Module) `[TRIVIAL]`
+                                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                      ### 📁 `static-context/`
+
+                      - 🏗️ **Layers:** Unknown
+                      - 📊 **Tiers:** TRIVIAL: 8
+                      - 📄 **Files:** 2
+                      - 📦 **Entities:** 8
+
+                      **Key Entities:**
+
+                        - 📦 **StaticContextService** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+                        - 📦 **tree-sitter-utils** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `filtering/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 2
+                    - 📄 **Files:** 1
+                    - 📦 **Entities:** 2
+
+                    **Key Entities:**
+
+                      - 📦 **BracketMatchingService.test** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                      ### 📁 `streamTransforms/`
+
+                      - 🏗️ **Layers:** Unknown
+                      - 📊 **Tiers:** TRIVIAL: 8
+                      - 📄 **Files:** 3
+                      - 📦 **Entities:** 8
+
+                      **Key Entities:**
+
+                        - 📦 **charStream.test** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+                        - 📦 **lineStream** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+                        - 📦 **lineStream.test** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                      ### 📁 `test/`
+
+                      - 🏗️ **Layers:** Unknown
+                      - 📊 **Tiers:** TRIVIAL: 15
+                      - 📄 **Files:** 2
+                      - 📦 **Entities:** 15
+
+                      **Key Entities:**
+
+                        - 📦 **testCases** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+                        - 📦 **util** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `generation/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 4
+                    - 📄 **Files:** 2
+                    - 📦 **Entities:** 4
+
+                    **Key Entities:**
+
+                      - 📦 **GeneratorReuseManager.test** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **utils.test** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `postprocessing/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 9
+                    - 📄 **Files:** 2
+                    - 📦 **Entities:** 9
+
+                    **Key Entities:**
+
+                      - 📦 **index** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **removePrefixOverlap** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `prefiltering/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 3
+                    - 📄 **Files:** 1
+                    - 📦 **Entities:** 3
+
+                    **Key Entities:**
+
+                      - 📦 **index** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `snippets/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 4
+                    - 📄 **Files:** 1
+                    - 📦 **Entities:** 4
+
+                    **Key Entities:**
+
+                      - 📦 **getAllSnippets** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `templating/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 23
+                    - 📄 **Files:** 6
+                    - 📦 **Entities:** 23
+
+                    **Key Entities:**
+
+                      - 📦 **AutocompleteTemplate** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **constructPrefixSuffix** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **filtering** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **formatOpenedFilesContext** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **getStopTokens** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **index** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                      ### 📁 `__tests__/`
+
+                      - 🏗️ **Layers:** Unknown
+                      - 📊 **Tiers:** TRIVIAL: 2
+                      - 📄 **Files:** 1
+                      - 📦 **Entities:** 2
+
+                      **Key Entities:**
+
+                        - 📦 **renderPrompt.test** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `util/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 12
+                    - 📄 **Files:** 5
+                    - 📦 **Entities:** 12
+
+                    **Key Entities:**
+
+                      - 📦 **AutocompleteLruCacheInMem** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **ast** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **completionTestUtils** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **processSingleLineCompletion** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+                      - 📦 **textSimilarity** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                  ### 📁 `diff/`
+
+                  - 🏗️ **Layers:** Unknown
+                  - 📊 **Tiers:** TRIVIAL: 13
+                  - 📄 **Files:** 3
+                  - 📦 **Entities:** 13
+
+                  **Key Entities:**
+
+                    - 📦 **myers** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **streamDiff.test** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **util** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                  ### 📁 `fetch/`
+
+                  - 🏗️ **Layers:** Unknown
+                  - 📊 **Tiers:** TRIVIAL: 2
+                  - 📄 **Files:** 1
+                  - 📦 **Entities:** 2
+
+                  **Key Entities:**
+
+                    - 📦 **stream** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                  ### 📁 `indexing/`
+
+                  - 🏗️ **Layers:** Unknown
+                  - 📊 **Tiers:** TRIVIAL: 2
+                  - 📄 **Files:** 1
+                  - 📦 **Entities:** 2
+
+                  **Key Entities:**
+
+                    - 📦 **ignore** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                  ### 📁 `llm/`
+
+                  - 🏗️ **Layers:** Unknown
+                  - 📊 **Tiers:** TRIVIAL: 27
+                  - 📄 **Files:** 4
+                  - 📦 **Entities:** 27
+
+                  **Key Entities:**
+
+                    - 📦 **countTokens** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **llamaTokenizer** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **messages** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **openaiTypeConverters** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `model-info/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 2
+                    - 📄 **Files:** 1
+                    - 📦 **Entities:** 2
+
+                    **Key Entities:**
+
+                      - 📦 **index** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                  ### 📁 `test/`
+
+                  - 🏗️ **Layers:** Unknown
+                  - 📊 **Tiers:** TRIVIAL: 4
+                  - 📄 **Files:** 1
+                  - 📦 **Entities:** 4
+
+                  **Key Entities:**
+
+                    - 📦 **testDir** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                  ### 📁 `util/`
+
+                  - 🏗️ **Layers:** Unknown
+                  - 📊 **Tiers:** TRIVIAL: 41
+                  - 📄 **Files:** 10
+                  - 📦 **Entities:** 41
+
+                  **Key Entities:**
+
+                    - 📦 **index** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **lcs** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **logger** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **merge** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **messageContent** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **pathToUri** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **paths** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **ranges** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **treeSitter** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+                    - 📦 **uri** (Module) `[TRIVIAL]`
+                      - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                    ### 📁 `src/`
+
+                    - 🏗️ **Layers:** Unknown
+                    - 📊 **Tiers:** TRIVIAL: 5
+                    - 📄 **Files:** 1
+                    - 📦 **Entities:** 5
+
+                    **Key Entities:**
+
+                      - 📦 **VSCodeIde** (Module) `[TRIVIAL]`
+                        - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+                      ### 📁 `autocomplete/`
+
+                      - 🏗️ **Layers:** Unknown
+                      - 📊 **Tiers:** TRIVIAL: 13
+                      - 📄 **Files:** 1
+                      - 📦 **Entities:** 13
+
+                      **Key Entities:**
+
+                        - 📦 **lsp** (Module) `[TRIVIAL]`
+                          - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `shims/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 4
+              - 📄 **Files:** 2
+              - 📦 **Entities:** 4
+
+              **Key Entities:**
+
+                - 📦 **FileIgnoreController** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **i18n** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `cli-backend/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 7
+            - 📄 **Files:** 3
+            - 📦 **Entities:** 7
+
+            **Key Entities:**
+
+              - 📦 **connection-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **server-manager** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **server-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `i18n/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 4
+              - 📄 **Files:** 1
+              - 📦 **Entities:** 4
+
+              **Key Entities:**
+
+                - 📦 **index** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `code-actions/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 11
+            - 📄 **Files:** 4
+            - 📦 **Entities:** 11
+
+            **Key Entities:**
+
+              - 📦 **editor-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **register-code-actions** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **register-terminal-actions** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **support-prompt** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `commit-message/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 2
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 2
+
+            **Key Entities:**
+
+              - 📦 **index** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `marketplace/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 15
+            - 📄 **Files:** 3
+            - 📦 **Entities:** 15
+
+            **Key Entities:**
+
+              - 📦 **api** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **installer** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **paths** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `telemetry/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 8
+            - 📄 **Files:** 2
+            - 📦 **Entities:** 8
+
+            **Key Entities:**
+
+              - 📦 **errors** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **telemetry-proxy-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+          ### 📁 `shared/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 10
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 10
+
+          **Key Entities:**
+
+            - 📦 **custom-provider** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **provider-model** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+        ### 📁 `tests/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 7
+        - 📄 **Files:** 2
+        - 📦 **Entities:** 7
+
+        **Key Entities:**
+
+          - 📦 **permission-dock-dropdown.spec** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+          - 📦 **visual-regression.spec** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+          ### 📁 `unit/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 90
+          - 📄 **Files:** 27
+          - 📦 **Entities:** 90
+
+          **Key Entities:**
+
+            - 📦 **agent-manager-arch.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **agent-manager-diff-state.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **agent-manager-i18n-split.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **agent-manager-i18n.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **autocomplete-inline-utils.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **code-action-provider.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **connection-utils.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **date.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **extension-arch.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **file-ignore-controller.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+          ### 📁 `agent-manager/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 41
+          - 📄 **Files:** 9
+          - 📦 **Entities:** 41
+
+          **Key Entities:**
+
+            - 📦 **apply-conflicts** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **diff-open-policy** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **diff-state** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **file-tree-utils** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **multi-model-utils** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **navigate** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **review-annotations** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **review-comments** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+            - 📦 **tab-order** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `chat/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 11
+              - 📄 **Files:** 3
+              - 📦 **Entities:** 11
+
+              **Key Entities:**
+
+                - 📦 **permission-dock-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **prompt-input-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **question-dock-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `marketplace/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 3
+              - 📄 **Files:** 1
+              - 📦 **Entities:** 3
+
+              **Key Entities:**
+
+                - 📦 **utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `settings/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 9
+              - 📄 **Files:** 2
+              - 📦 **Entities:** 9
+
+              **Key Entities:**
+
+                - 📦 **provider-catalog** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+                - 📦 **provider-visibility** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+              ### 📁 `shared/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 7
+              - 📄 **Files:** 1
+              - 📦 **Entities:** 7
+
+              **Key Entities:**
+
+                - 📦 **model-selector-utils** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `context/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 20
+            - 📄 **Files:** 6
+            - 📦 **Entities:** 20
+
+            **Key Entities:**
+
+              - 📦 **language-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **model-selection** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **permission-queue** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **provider-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **session-queue** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **session-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `hooks/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 25
+            - 📄 **Files:** 6
+            - 📦 **Entities:** 25
+
+            **Key Entities:**
+
+              - 📦 **file-mention-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **image-attachments-utils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **useFileMention** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **useImageAttachments** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **usePromptHistory** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **useSlashCommand** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `types/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 2
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 2
+
+            **Key Entities:**
+
+              - 📦 **messages** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+            ### 📁 `utils/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 23
+            - 📄 **Files:** 6
+            - 📦 **Entities:** 23
+
+            **Key Entities:**
+
+              - 📦 **date** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **errorUtils** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **id** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **provider-action** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **qrcode** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+              - 📦 **review-comment-markdown** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/kilo-vs...
+
+        ### 📁 `script/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 2
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 📦 **schema** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `acp/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 15
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 15
+
+          **Key Entities:**
+
+            - 📦 **agent** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `agent/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 6
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 6
+
+          **Key Entities:**
+
+            - 📦 **agent** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `auth/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 5
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `bun/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 8
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 8
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **registry** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `bus/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **bus-event** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `cli/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 18
+          - 📄 **Files:** 5
+          - 📦 **Entities:** 18
+
+          **Key Entities:**
+
+            - 📦 **bootstrap** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **error** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **network** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **ui** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **upgrade** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `cmd/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 68
+            - 📄 **Files:** 10
+            - 📦 **Entities:** 68
+
+            **Key Entities:**
+
+              - 📦 **auth** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **cmd** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **import** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **mcp** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **models** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **run** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **session** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **stats** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **uninstall** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **web** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+              ### 📁 `debug/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 5
+              - 📄 **Files:** 1
+              - 📦 **Entities:** 5
+
+              **Key Entities:**
+
+                - 📦 **agent** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/opencod...
+
+              ### 📁 `tui/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 12
+              - 📄 **Files:** 3
+              - 📦 **Entities:** 12
+
+              **Key Entities:**
+
+                - 📦 **thread** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/opencod...
+                - 📦 **win32** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/opencod...
+                - 📦 **worker** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/opencod...
+
+                ### 📁 `component/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 3
+                - 📄 **Files:** 1
+                - 📦 **Entities:** 3
+
+                **Key Entities:**
+
+                  - 📦 **textarea-keybindings** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+
+                ### 📁 `context/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 2
+                - 📄 **Files:** 1
+                - 📦 **Entities:** 2
+
+                **Key Entities:**
+
+                  - 📦 **directory** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+
+                ### 📁 `ui/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 8
+                - 📄 **Files:** 1
+                - 📦 **Entities:** 8
+
+                **Key Entities:**
+
+                  - 📦 **spinner** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+
+                ### 📁 `util/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 27
+                - 📄 **Files:** 7
+                - 📦 **Entities:** 27
+
+                **Key Entities:**
+
+                  - 📦 **clipboard** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **editor** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **markdown** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **selection** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **signal** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **terminal** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **transcript** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `command/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `commit-message/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 12
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 12
+
+          **Key Entities:**
+
+            - 📦 **generate** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **git-context** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `__tests__/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 10
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 10
+
+            **Key Entities:**
+
+              - 📦 **git-context.test** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `config/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 54
+          - 📄 **Files:** 5
+          - 📦 **Entities:** 54
+
+          **Key Entities:**
+
+            - 📦 **config** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **markdown** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **migrate-tui-config** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **paths** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **tui** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `control/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `control-plane/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **sse** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **workspace** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **workspace-router-middleware** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `adaptors/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 3
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 3
+
+            **Key Entities:**
+
+              - 📦 **index** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `workspace-server/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 5
+            - 📄 **Files:** 2
+            - 📦 **Entities:** 5
+
+            **Key Entities:**
+
+              - 📦 **routes** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **server** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `env/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 5
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `file/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 28
+          - 📄 **Files:** 5
+          - 📦 **Entities:** 28
+
+          **Key Entities:**
+
+            - 📦 **ignore** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **ripgrep** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **time** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **watcher** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `flag/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **flag** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `format/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 5
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `id/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 8
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 8
+
+          **Key Entities:**
+
+            - 📦 **id** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `ide/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `installation/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 8
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 8
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `kilo-sessions/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 31
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 31
+
+          **Key Entities:**
+
+            - 📦 **inflight-cache** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **ingest-queue** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **kilo-sessions** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `kilocode/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 90
+          - 📄 **Files:** 18
+          - 📦 **Entities:** 90
+
+          **Key Entities:**
+
+            - 📦 **bash-hierarchy** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **bell** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **cloud-session** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **config-injector** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **editor-context** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **enhance-prompt** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **ignore-migrator** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **kilo-errors** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **mcp-migrator** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **modes-migrator** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `permission/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 2
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 2
+
+            **Key Entities:**
+
+              - 📦 **drain** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `review/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 31
+            - 📄 **Files:** 3
+            - 📦 **Entities:** 31
+
+            **Key Entities:**
+
+              - 📦 **command** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **review** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **worktree-diff** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `lsp/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 26
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 26
+
+          **Key Entities:**
+
+            - 📦 **client** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **server** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `mcp/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 46
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 46
+
+          **Key Entities:**
+
+            - 📦 **auth** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **oauth-callback** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `patch/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 17
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 17
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `permission/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 17
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 17
+
+          **Key Entities:**
+
+            - 📦 **arity** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **next** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `plugin/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 23
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 23
+
+          **Key Entities:**
+
+            - 📦 **codex** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **copilot** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `project/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 27
+          - 📄 **Files:** 5
+          - 📦 **Entities:** 27
+
+          **Key Entities:**
+
+            - 📦 **bootstrap** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **instance** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **project** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **state** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **vcs** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `provider/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 57
+          - 📄 **Files:** 6
+          - 📦 **Entities:** 57
+
+          **Key Entities:**
+
+            - 📦 **auth** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **error** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **model-cache** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **models** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **provider** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **transform** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+              ### 📁 `copilot/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 2
+              - 📄 **Files:** 1
+              - 📦 **Entities:** 2
+
+              **Key Entities:**
+
+                - 📦 **copilot-provider** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/opencod...
+
+                ### 📁 `chat/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 9
+                - 📄 **Files:** 4
+                - 📦 **Entities:** 9
+
+                **Key Entities:**
+
+                  - 📦 **convert-to-openai-compatible-chat-messages** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **get-response-metadata** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **map-openai-compatible-finish-reason** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **openai-compatible-prepare-tools** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+
+                ### 📁 `responses/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 26
+                - 📄 **Files:** 4
+                - 📦 **Entities:** 26
+
+                **Key Entities:**
+
+                  - 📦 **convert-to-openai-responses-input** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **map-openai-responses-finish-reason** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **openai-responses-language-model** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+                  - 📦 **openai-responses-prepare-tools** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `pty/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `question/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 5
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `scheduler/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 3
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 3
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `server/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **error** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **mdns** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **server** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `routes/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 4
+            - 📄 **Files:** 2
+            - 📦 **Entities:** 4
+
+            **Key Entities:**
+
+              - 📦 **global** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+              - 📦 **tui** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `session/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 75
+          - 📄 **Files:** 13
+          - 📦 **Entities:** 75
+
+          **Key Entities:**
+
+            - 📦 **compaction** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **instruction** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **llm** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **message-v2** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **processor** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **prompt** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **retry** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **revert** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **status** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `share/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **share-next** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `shell/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 3
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 3
+
+          **Key Entities:**
+
+            - 📦 **shell** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `skill/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 9
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 9
+
+          **Key Entities:**
+
+            - 📦 **discovery** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **skill** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `snapshot/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 13
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 13
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `storage/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 19
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 19
+
+          **Key Entities:**
+
+            - 📦 **db** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **json-migration** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **storage** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `tool/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 37
+          - 📄 **Files:** 12
+          - 📦 **Entities:** 37
+
+          **Key Entities:**
+
+            - 📦 **diagnostics** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **edit** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **external-directory** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **ls** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **plan** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **question** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **read** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **registry** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **task** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **tool** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `util/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 109
+          - 📄 **Files:** 28
+          - 📦 **Entities:** 109
+
+          **Key Entities:**
+
+            - 📦 **abort** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **archive** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **color** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **context** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **defer** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **eventloop** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **filesystem** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **fn** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **format** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **git** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `worktree/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 18
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 18
+
+          **Key Entities:**
+
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `acp/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 6
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 6
+
+          **Key Entities:**
+
+            - 📦 **event-subscription.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `agent/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **agent.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `cli/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 3
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 3
+
+          **Key Entities:**
+
+            - 📦 **plugin-auth-picker.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `tui/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 3
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 3
+
+            **Key Entities:**
+
+              - 📦 **thread.test** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `config/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **config.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `control-plane/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **session-proxy-middleware.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **sse.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `fixture/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 8
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 8
+
+          **Key Entities:**
+
+            - 📦 **db** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **fixture** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `lsp/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 6
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 6
+
+            **Key Entities:**
+
+              - 📦 **fake-lsp-server** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `kilo-sessions/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 4
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 4
+
+          **Key Entities:**
+
+            - 📦 **inflight-cache.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **ingest-queue.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `kilocode/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 33
+          - 📄 **Files:** 11
+          - 📦 **Entities:** 33
+
+          **Key Entities:**
+
+            - 📦 **bash-hierarchy.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **kilo-errors.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **local-model.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **patch-jsonc.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **paths.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **plan-exit-detection.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **plan-followup.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **rules-migrator.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **workflows-migrator.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **worktree-diff-summary.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `lsp/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **client.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `plugin/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **codex.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `project/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 3
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 3
+
+          **Key Entities:**
+
+            - 📦 **project.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+            ### 📁 `copilot/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 4
+            - 📄 **Files:** 1
+            - 📦 **Entities:** 4
+
+            **Key Entities:**
+
+              - 📦 **copilot-chat-model.test** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `session/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 20
+          - 📄 **Files:** 6
+          - 📦 **Entities:** 20
+
+          **Key Entities:**
+
+            - 📦 **compaction.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **llm.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **message-v2.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **prompt.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **retry.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **structured-output-integration.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `skill/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **skill.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `snapshot/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **snapshot.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `storage/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 5
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 5
+
+          **Key Entities:**
+
+            - 📦 **json-migration.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `tool/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **webfetch.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+          ### 📁 `util/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 10
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 10
+
+          **Key Entities:**
+
+            - 📦 **lock.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **process.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+            - 📦 **which.test** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/opencod...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 2
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 📦 **tool** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/plugin/...
+
+          ### 📁 `script/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **publish** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/sdk/js/...
+
+          ### 📁 `src/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 10
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 10
+
+          **Key Entities:**
+
+            - 📦 **client** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/sdk/js/...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/sdk/js/...
+            - 📦 **server** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/sdk/js/...
+
+            ### 📁 `v2/`
+
+            - 🏗️ **Layers:** Unknown
+            - 📊 **Tiers:** TRIVIAL: 10
+            - 📄 **Files:** 3
+            - 📦 **Entities:** 10
+
+            **Key Entities:**
+
+              - 📦 **client** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/sdk/js/...
+              - 📦 **index** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/sdk/js/...
+              - 📦 **server** (Module) `[TRIVIAL]`
+                - Auto-generated module for research/kilocode/packages/sdk/js/...
+
+                ### 📁 `core/`
+
+                - 🏗️ **Layers:** Unknown
+                - 📊 **Tiers:** TRIVIAL: 2
+                - 📄 **Files:** 1
+                - 📦 **Entities:** 2
+
+                **Key Entities:**
+
+                  - 📦 **utils.gen** (Module) `[TRIVIAL]`
+                    - Auto-generated module for research/kilocode/packages/sdk/js/...
+
+        ### 📁 `.storybook/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 2
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 2
+
+        **Key Entities:**
+
+          - 📦 **theme-tool** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/storybo...
+
+              ### 📁 `context/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 30
+              - 📄 **Files:** 12
+              - 📦 **Entities:** 30
+
+              **Key Entities:**
+
+                - 📦 **command** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **comments** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **file** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **global-sync** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **language** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **layout** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **local** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **permission** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **platform** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+                - 📦 **prompt** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+
+              ### 📁 `hooks/`
+
+              - 🏗️ **Layers:** Unknown
+              - 📊 **Tiers:** TRIVIAL: 2
+              - 📄 **Files:** 1
+              - 📦 **Entities:** 2
+
+              **Key Entities:**
+
+                - 📦 **use-providers** (Module) `[TRIVIAL]`
+                  - Auto-generated module for research/kilocode/packages/storybo...
+
+      ### 📁 `ui/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 3
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 3
+
+      **Key Entities:**
+
+        - 📦 **vite.config** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/packages/ui/vite...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 3
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 3
+
+        **Key Entities:**
+
+          - 📦 **file-path** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/ui/src/...
+
+          ### 📁 `components/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 6
+          - 📄 **Files:** 2
+          - 📦 **Entities:** 6
+
+          **Key Entities:**
+
+            - 📦 **line-comment-styles** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **session-review-search** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+
+          ### 📁 `pierre/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 67
+          - 📄 **Files:** 11
+          - 📦 **Entities:** 67
+
+          **Key Entities:**
+
+            - 📦 **comment-hover** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **commented-lines** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **diff-selection** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **file-find** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **file-runtime** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **file-selection** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **index** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **media** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **selection-bridge** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **virtualizer** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+
+          ### 📁 `storybook/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 2
+          - 📄 **Files:** 1
+          - 📦 **Entities:** 2
+
+          **Key Entities:**
+
+            - 📦 **fixtures** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+
+          ### 📁 `theme/`
+
+          - 🏗️ **Layers:** Unknown
+          - 📊 **Tiers:** TRIVIAL: 37
+          - 📄 **Files:** 3
+          - 📦 **Entities:** 37
+
+          **Key Entities:**
+
+            - 📦 **color** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **loader** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+            - 📦 **resolve** (Module) `[TRIVIAL]`
+              - Auto-generated module for research/kilocode/packages/ui/src/...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 33
+        - 📄 **Files:** 10
+        - 📦 **Entities:** 33
+
+        **Key Entities:**
+
+          - 📦 **array** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **binary** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **encode** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **fn** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **identifier** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **iife** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **lazy** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **path** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **retry** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+          - 📦 **slug** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/packages/util/sr...
+
+    ### 📁 `script/`
+
+    - 🏗️ **Layers:** Unknown
+    - 📊 **Tiers:** TRIVIAL: 25
+    - 📄 **Files:** 5
+    - 📦 **Entities:** 25
+
+    **Key Entities:**
+
+      - 📦 **beta** (Module) `[TRIVIAL]`
+        - Auto-generated module for research/kilocode/script/beta.ts
+      - 📦 **changelog** (Module) `[TRIVIAL]`
+        - Auto-generated module for research/kilocode/script/changelog...
+      - 📦 **duplicate-pr** (Module) `[TRIVIAL]`
+        - Auto-generated module for research/kilocode/script/duplicate...
+      - 📦 **stats** (Module) `[TRIVIAL]`
+        - Auto-generated module for research/kilocode/script/stats.ts
+      - 📦 **sync-zed** (Module) `[TRIVIAL]`
+        - Auto-generated module for research/kilocode/script/sync-zed....
+
+      ### 📁 `upstream/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 10
+      - 📄 **Files:** 3
+      - 📦 **Entities:** 10
+
+      **Key Entities:**
+
+        - 📦 **analyze** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/script/upstream/...
+        - 📦 **list-versions** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/script/upstream/...
+        - 📦 **merge** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/script/upstream/...
+
+        ### 📁 `codemods/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 7
+        - 📄 **Files:** 2
+        - 📦 **Entities:** 7
+
+        **Key Entities:**
+
+          - 📦 **transform-imports** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **transform-strings** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+
+        ### 📁 `transforms/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 74
+        - 📄 **Files:** 12
+        - 📦 **Entities:** 74
+
+        **Key Entities:**
+
+          - 📦 **keep-ours** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **lock-files** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **package-names** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **preserve-versions** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **skip-files** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **transform-extensions** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **transform-i18n** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **transform-package-json** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **transform-scripts** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **transform-take-theirs** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+
+        ### 📁 `utils/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 66
+        - 📄 **Files:** 5
+        - 📦 **Entities:** 66
+
+        **Key Entities:**
+
+          - 📦 **config** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **git** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **logger** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **report** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+          - 📦 **version** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/script/upstream/...
+
+      ### 📁 `vscode/`
+
+      - 🏗️ **Layers:** Unknown
+      - 📊 **Tiers:** TRIVIAL: 2
+      - 📄 **Files:** 1
+      - 📦 **Entities:** 2
+
+      **Key Entities:**
+
+        - 📦 **esbuild** (Module) `[TRIVIAL]`
+          - Auto-generated module for research/kilocode/sdks/vscode/esbu...
+
+        ### 📁 `src/`
+
+        - 🏗️ **Layers:** Unknown
+        - 📊 **Tiers:** TRIVIAL: 6
+        - 📄 **Files:** 1
+        - 📦 **Entities:** 6
+
+        **Key Entities:**
+
+          - 📦 **extension** (Module) `[TRIVIAL]`
+            - Auto-generated module for research/kilocode/sdks/vscode/src/...
+
+### 📁 `root/`
+
+- 🏗️ **Layers:** DevOps/Tooling
+- 📊 **Tiers:** CRITICAL: 11, STANDARD: 18, TRIVIAL: 14
+- 📄 **Files:** 2
+- 📦 **Entities:** 43
+
+**Key Entities:**
+
+  - ℂ **Complexity** (Class) `[TRIVIAL]`
+    - Adaptive semantic complexity scale used for validation stric...
+  - ℂ **ComplianceIssue** (Class) `[TRIVIAL]`
+    - Represents a single compliance issue with severity.
+  - ℂ **SemanticEntity** (Class) `[CRITICAL]`
+    - Represents a code entity (Module, Function, Component) found...
+  - ℂ **SemanticMapGenerator** (Class) `[CRITICAL]`
+    - Orchestrates the mapping process with tier-based validation.
+  - ℂ **Severity** (Class) `[TRIVIAL]`
+    - Severity levels for compliance issues.
+  - ℂ **Tier** (Class) `[TRIVIAL]`
+    - Legacy tier buckets retained for backward-compatible reporti...
+  - 📦 **MergeSpec** (Module) `[TRIVIAL]`
+    - Utility to merge specs
+  - 📦 **generate_semantic_map** (Module)
+    - Scans the codebase to generate a Semantic Map, Module Map, a...
+  - 📦 **merge_spec** (Module) `[TRIVIAL]`
+    - Utility script for merge_spec
+
+## Cross-Module Dependencies
+
+```mermaid
+graph TD
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|CALLS|backend
+    routes-->|DISPATCHES|backend
+    routes-->|CALLS|backend
+    routes-->|DISPATCHES|backend
+    routes-->|CALLS|backend
+    routes-->|CALLS|backend
+    routes-->|USES|backend
+    routes-->|USES|backend
+    routes-->|CALLS|backend
+    routes-->|CALLS|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|CALLS|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|CALLS|backend
+    routes-->|CALLS|backend
+    routes-->|CALLS|backend
+    routes-->|CALLS|backend
+    routes-->|CALLS|root
+    routes-->|CALLS|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    routes-->|DEPENDS_ON|backend
+    __tests__-->|DEPENDS_ON|backend
+    __tests__-->|DEPENDS_ON|backend
+    __tests__-->|DEPENDS_ON|backend
+    __tests__-->|DEPENDS_ON|backend
+    __tests__-->|DEPENDS_ON|backend
+    __tests__-->|VERIFIES|backend
+    core-->|DEPENDS_ON|backend
+    core-->|DEPENDS_ON|backend
+    utils-->|DEPENDS_ON|backend
+    utils-->|DEPENDS_ON|backend
+    llm_analysis-->|IMPLEMENTS|backend
+    llm_analysis-->|IMPLEMENTS|backend
+    storage-->|DEPENDS_ON|backend
+    scripts-->|READS_FROM|backend
+    scripts-->|READS_FROM|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|CALLS|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|CALLS|backend
+    services-->|DEPENDS_ON|backend
+    services-->|USED_BY|backend
+    services-->|USED_BY|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    services-->|DEPENDS_ON|backend
+    __tests__-->|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
+    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
+    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__-->|VERIFIES|backend
+    __tests__-->|DEPENDS_ON|backend
+    stages-->|IMPLEMENTS|backend
+    stages-->|DEPENDS_ON|backend
+    stages-->|IMPLEMENTS|backend
+    stages-->|DEPENDS_ON|backend
+    stages-->|IMPLEMENTS|backend
+    stages-->|DEPENDS_ON|backend
+    stages-->|CALLED_BY|backend
+    stages-->|DEPENDS_ON|backend
+    stages-->|IMPLEMENTS|backend
+    stages-->|DEPENDS_ON|backend
+    stages-->|DEPENDS_ON|backend
+    reports-->|DEPENDS_ON|backend
+    reports-->|DEPENDS_ON|backend
+    reports-->|DEPENDS_ON|backend
+    clean_release-->|DEPENDS_ON|backend
+    dataset_review-->|DEPENDS_ON|backend
+    components-->|USED_BY|routes
+    components-->|USES|lib
+    components-->|USED_BY|routes
+    components-->|USES|lib
+    __tests__-->|VERIFIES|components
+    llm-->|DEPENDS_ON|backend
+    tools-->|USES|services
+    tools-->|USES|services
+    tools-->|USES|services
+    tools-->|USES|services
+    tools-->|USES|services
+    __tests__-->|TESTS|lib
+    __tests__-->|TESTS|routes
+    __tests__-->|TESTS|routes
+    __tests__-->|TESTS|lib
+    __tests__-->|TESTS|lib
+    __tests__-->|TESTS|routes
+    __tests__-->|TESTS|routes
+    __tests__-->|VERIFIES|routes
+    __tests__-->|TESTS|routes
+    __tests__-->|TESTS|routes
+    fixtures-->|DEPENDS_ON|lib
+    [taskId]-->|VERIFIES|routes
+```
diff --git a/.ai/structure/PROJECT_MAP.md b/.ai/structure/PROJECT_MAP.md
index 993b20e5..44ac87ea 100644
--- a/.ai/structure/PROJECT_MAP.md
+++ b/.ai/structure/PROJECT_MAP.md
@@ -1,4 +1,7 @@
-# Project Semantic Map
+# Generated Project Semantic Map Snapshot
+
+> Canonical `Project_Map` ownership is defined in `.ai/PROJECT_MAP.md`.
+> This file is a generated backing snapshot and should not be treated as the canonical ownership document.
 
 > Compressed view for AI Context. Generated automatically.
 
@@ -6879,11 +6882,19 @@
     - 📝 Toggle assistant panel visibility.
   - ƒ **openAssistantChat** (`Function`) `[TRIVIAL]`
     - 📝 Open assistant panel.
+  - ƒ **openAssistantChatWithContext** (`Function`) `[TRIVIAL]`
+    - 📝 Open assistant panel with dataset review session context and optional seeded prompt/focus target.
   - ƒ **closeAssistantChat** (`Function`) `[TRIVIAL]`
     - 📝 Close assistant panel.
   - ƒ **setAssistantConversationId** (`Function`) `[TRIVIAL]`
     - 📝 Bind current conversation id in UI state.
-- 🗄️ **taskDrawer** (`Store`) `[CRITICAL]`
+  - ƒ **setAssistantDatasetReviewSessionId** (`Function`) `[TRIVIAL]`
+    - 📝 Bind active dataset review session to assistant state.
+  - ƒ **setAssistantSeedMessage** (`Function`) `[TRIVIAL]`
+    - 📝 Stage a seeded assistant prompt for contextual send UX.
+  - ƒ **setAssistantFocusTarget** (`Function`) `[TRIVIAL]`
+    - 📝 Track the workspace entity currently referenced by assistant context.
+- 🗄️ **taskDrawer** (`Store`)
   - 📝 Manage Task Drawer visibility and resource-to-task mapping
   - 🏗️ Layer: UI
   - 🔒 Invariant: resourceTaskMap always reflects current task associations
@@ -7040,12 +7051,14 @@
   - ƒ **getReportDetail** (`Function`) `[TRIVIAL]`
     - 📝 Fetch one report detail by report_id.
 - 📦 **AssistantApi** (`Module`)
-  - 📝 API client wrapper for assistant chat, confirmation actions, and history retrieval.
+  - 📝 API client wrapper for assistant chat, session-scoped prompts, confirmation actions, and history retrieval.
   - 🏗️ Layer: Infra-API
   - 🔒 Invariant: All assistant requests must use requestApi wrapper (no native fetch).
   - 🔗 DEPENDS_ON -> `api_module`
   - ƒ **sendAssistantMessage** (`Function`) `[TRIVIAL]`
     - 📝 Send a user message to assistant orchestrator endpoint.
+  - ƒ **buildAssistantSeedMessage** (`Function`) `[TRIVIAL]`
+    - 📝 Compose visible assistant seed text from context label and prompt body.
   - ƒ **confirmAssistantOperation** (`Function`) `[TRIVIAL]`
     - 📝 Confirm a pending risky assistant operation.
   - ƒ **cancelAssistantOperation** (`Function`) `[TRIVIAL]`
@@ -7056,6 +7069,22 @@
     - 📝 Retrieve paginated conversation list for assistant sidebar/history switcher.
   - ƒ **deleteAssistantConversation** (`Function`) `[TRIVIAL]`
     - 📝 Soft-delete or hard-delete a conversation.
+- 📦 **DatasetReviewApi** (`Module`)
+  - 📝 Provide shared frontend helpers for dataset review session-scoped API requests, optimistic-lock propagation, and refreshed session DTO normalization.
+  - 🏗️ Layer: Infra-API
+  - 🔗 DEPENDS_ON -> `api_module`
+  - ƒ **buildDatasetReviewRequestOptions** (`Function`) `[TRIVIAL]`
+    - 📝 Attach optimistic-lock session version header when the current version is known.
+  - ƒ **requestDatasetReviewApi** (`Function`) `[TRIVIAL]`
+    - 📝 Proxy dataset review mutations through requestApi with optional optimistic-lock headers.
+  - ƒ **isDatasetReviewConflictError** (`Function`) `[TRIVIAL]`
+    - 📝 Detect optimistic-lock conflicts from dataset review mutations.
+  - ƒ **getDatasetReviewConflictMessage** (`Function`) `[TRIVIAL]`
+    - 📝 Return explicit 409-style guidance for stale dataset review mutations.
+  - ƒ **extractDatasetReviewVersion** (`Function`) `[TRIVIAL]`
+    - 📝 Resolve the latest session version from refreshed DTO fragments.
+  - ƒ **normalizeDatasetReviewDetail** (`Function`) `[TRIVIAL]`
+    - 📝 Normalize refreshed session-detail DTOs into the legacy route-friendly workspace shape.
 - 📦 **ReportsApiTest** (`Module`)
   - 📝 Unit tests for reports API client functions: query string building, error normalization, and fetch wrappers.
   - 🏗️ Layer: Infra (Tests)
@@ -7072,6 +7101,13 @@
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `bindable`
   - ➡️ WRITES_TO `props`
+  - 🔗 DEPENDS_ON -> `Utils`
+- 🧩 **Icon** (`Component`) `[TRIVIAL]`
+  - 📝 Render the shared inline SVG icon set with consistent sizing and stroke props.
+  - 🏗️ Layer: Atom
+  - 🔒 Invariant: Icon output remains aria-hidden because labels belong to the interactive parent.
+  - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `derived`
 - 📦 **ui** (`Module`) `[TRIVIAL]`
   - 📝 Central export point for standardized UI components.
   - 🏗️ Layer: Atom
@@ -7081,17 +7117,20 @@
   - 🏗️ Layer: Atom
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `props`
+  - 🔗 DEPENDS_ON -> `Utils`
 - 🧩 **Card** (`Component`) `[TRIVIAL]`
   - 📝 Standardized container with padding and elevation.
   - 🏗️ Layer: Atom
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `props`
+  - 🔗 DEPENDS_ON -> `Utils`
 - 🧩 **Button** (`Component`) `[TRIVIAL]`
   - 📝 Define component interface and default values (Svelte 5 Runes).
   - 🏗️ Layer: Atom
   - 🔒 Invariant: Supports accessible labels and keyboard navigation.
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `props`
+  - 🔗 DEPENDS_ON -> `Utils`
 - 🧩 **Input** (`Component`) `[TRIVIAL]`
   - 📝 Standardized text input component with label and error handling.
   - 🏗️ Layer: Atom
@@ -7099,12 +7138,14 @@
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `bindable`
   - ➡️ WRITES_TO `props`
+  - 🔗 DEPENDS_ON -> `Utils`
 - 🧩 **LanguageSwitcher** (`Component`) `[TRIVIAL]`
   - 📝 Dropdown component to switch between supported languages.
   - 🏗️ Layer: Atom
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `locale`
   - 🔗 BINDS_TO -> `i18n.locale`
+  - 🔗 DEPENDS_ON -> `Select`
 - 📦 **i18n** (`Module`)
   - 📝 Determines the starting locale.
   - 🏗️ Layer: Infra
@@ -7117,53 +7158,100 @@
     - 📝 Derived store providing the translation dictionary.
   - ƒ **_** (`Function`) `[TRIVIAL]`
     - 📝 Get translation by key path.
+- 🧩 **AssistantClarificationCard** (`Component`) `[TRIVIAL]`
+  - 📝 Render the active dataset-review clarification queue inside AssistantChatPanel so users can answer, skip, defer, and resume questions without leaving the assistant workspace. -->
+  - 🏗️ Layer: UI -->
+  - ⬅️ READS_FROM `props`
+  - ⬅️ READS_FROM `state`
+  - ⬅️ READS_FROM `derived`
+  - 🔗 CALLS -> `api_module`
+  - 🔗 BINDS_TO -> `AssistantChatPanel`
+  - 🔗 BINDS_TO -> `DatasetReviewWorkspace`
+- 📦 **AssistantClarificationCard** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/components/assistant/AssistantClarificationCard.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **loadClarificationState** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **normalizeAnswerValue** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **updateClarificationState** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **submitAnswer** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **resumeClarification** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **recordClarificationFeedback** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 🧩 **AssistantChatPanel** (`Component`)
-  - 📝 Slide-out assistant chat panel for natural language command execution and task tracking.
+  - 📝 Assistant chat workspace for mixed-initiative dataset review clarification, contextual actions, and task tracking.
   - 🏗️ Layer: UI
   - 🔒 Invariant: Risky operations are executed only through explicit confirm action.
   - ⬅️ READS_FROM `app`
   - ⬅️ READS_FROM `lib`
-  - ➡️ WRITES_TO `state`
+  - ➡️ WRITES_TO `props`
   - 🔗 BINDS_TO -> `assistantChat`
   - 🔗 CALLS -> `AssistantApi`
+  - 🔗 BINDS_TO -> `DatasetReviewWorkspace`
   - 🔗 DISPATCHES -> `taskDrawer`
-  - ƒ **loadHistory** (`Function`) `[TRIVIAL]`
-    - 📝 Load current conversation history when panel becomes visible.
-  - ƒ **loadConversations** (`Function`) `[TRIVIAL]`
-    - 📝 Load paginated conversation summaries for quick switching UI.
-  - ƒ **removeConversation** (`Function`) `[TRIVIAL]`
-    - 📝 Removes a conversation from the list and deletes it from the backend.
-  - ƒ **loadOlderMessages** (`Function`) `[TRIVIAL]`
-    - 📝 Lazy-load older messages for active conversation when user scrolls to top.
-  - ƒ **appendLocalUserMessage** (`Function`) `[TRIVIAL]`
-    - 📝 Add optimistic local user message before backend response.
-  - ƒ **appendAssistantResponse** (`Function`) `[TRIVIAL]`
-    - 📝 Normalize and append assistant response payload to chat list.
-  - ƒ **handleSend** (`Function`) `[TRIVIAL]`
-    - 📝 Submit user command to assistant orchestration API.
-  - ƒ **selectConversation** (`Function`) `[TRIVIAL]`
-    - 📝 Switch active chat context to selected conversation item.
-  - ƒ **startNewConversation** (`Function`) `[TRIVIAL]`
-    - 📝 Create local empty chat context that will be persisted on first message.
-  - ƒ **handleAction** (`Function`) `[TRIVIAL]`
-    - 📝 Execute assistant action button behavior (open task/reports, confirm, cancel).
-  - ƒ **handleKeydown** (`Function`) `[TRIVIAL]`
-    - 📝 Submit command by Enter while preserving multiline input with Shift+Enter.
-  - ƒ **stateClass** (`Function`) `[TRIVIAL]`
-    - 📝 Map assistant state to visual badge style class.
-  - ƒ **handleHistoryScroll** (`Function`) `[TRIVIAL]`
-    - 📝 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
+  - ƒ **loadHistory** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **loadConversations** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **removeConversation** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **loadOlderMessages** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **appendLocalUserMessage** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **appendAssistantResponse** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **buildConversationTitle** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **setConversationFilter** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **formatConversationTime** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **handleSend** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **selectConversation** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **startNewConversation** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleAction** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleKeydown** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **stateClass** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleHistoryScroll** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **loadLlmStatus** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **clearFocusTarget** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **buildContextSummary** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **isConfirmationCard** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getMessageFocusTarget** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **syncMessageFocus** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **renderConfirmationScope** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **hasConfirmationScope** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **dismissClarificationBanner** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **resumeClarificationFromBanner** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **refreshDatasetReviewSession** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleClarificationUpdated** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **AssistantFirstMessageIntegrationTest** (`Module`)
   - 📝 Verify first optimistic user message stays visible while a new conversation request is pending.
   - 🏗️ Layer: UI Tests
@@ -7178,18 +7266,24 @@
     - 📝 Read and parse JSON fixture file from disk.
   - ƒ **assistant_chat_contract_tests** (`Function`) `[TRIVIAL]`
     - 📝 Validate assistant chat component contract and locale integration without DOM runtime dependency.
+- 📦 **AssistantClarificationIntegrationTest** (`Module`)
+  - 📝 Verify AssistantChatPanel hosts the resumable dataset-review clarification flow inside the assistant drawer and refreshes workspace session state after answering.
+  - 🏗️ Layer: UI Tests
 - 🧩 **HealthMatrix** (`Component`)
-  - 📝 Visual grid/matrix representing the health status of dashboards.
-  - 🏗️ Layer: UI/Component
-  - ⬅️ READS_FROM `state`
+  - 📝 Visual grid summary representing dashboard health status counts.
+  - 🏗️ Layer: UI
   - ⬅️ READS_FROM `derived`
   - ⬅️ READS_FROM `lib`
+  - ➡️ WRITES_TO `props`
+  - 🔗 BINDS_TO -> `i18n`
 - 🧩 **PolicyForm** (`Component`)
   - 📝 Form for creating and editing validation policies.
-  - 🏗️ Layer: UI/Component
+  - 🏗️ Layer: UI
   - ⬅️ READS_FROM `state`
   - ⬅️ READS_FROM `derived`
   - ➡️ WRITES_TO `props`
+  - 🔗 DISPATCHES -> `onSave`
+  - 🔗 DISPATCHES -> `onCancel`
 - 📦 **PolicyForm** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/lib/components/health/PolicyForm.svelte
   - 🏗️ Layer: Unknown
@@ -7276,6 +7370,7 @@
 - 📦 **ReportsListTest** (`Module`)
   - 📝 Test ReportsList component iteration and event forwarding.
   - 🏗️ Layer: UI
+  - 🔗 DEPENDS_ON -> `ReportsList`
 - 📦 **ReportCardTest** (`Module`)
   - 📝 Test UX states and transitions for ReportCard component
   - 🏗️ Layer: UI
@@ -7334,6 +7429,12 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **recordFeedback** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **isFieldFocused** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **askAiAboutField** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **improveFieldDraft** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 🧩 **SourceIntakePanel** (`Component`) `[TRIVIAL]`
   - 📝 Collect initial dataset source input through Superset link paste or dataset selection entry paths. -->
   - 🏗️ Layer: UI -->
@@ -7360,30 +7461,6 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **handleSubmit** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- 🧩 **ClarificationDialog** (`Component`) `[TRIVIAL]`
-  - 📝 Present one clarification question at a time with explicit why-it-matters context, answer actions, and resumable state transitions for US2. -->
-  - 🏗️ Layer: UI -->
-  - ⬅️ READS_FROM `props`
-  - ⬅️ READS_FROM `state`
-  - ⬅️ READS_FROM `derived`
-  - 🔗 BINDS_TO -> `api_module`
-  - 🔗 BINDS_TO -> `assistantChat`
-  - 🔗 BINDS_TO -> `DatasetReviewWorkspace`
-- 📦 **ClarificationDialog** (`Module`) `[TRIVIAL]`
-  - 📝 Auto-generated module for frontend/src/lib/components/dataset-review/ClarificationDialog.svelte
-  - 🏗️ Layer: Unknown
-  - ƒ **clearFeedback** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **normalizeAnswerValue** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **recordClarificationFeedback** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **resumeClarification** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **submitAnswer** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **requestAssistantGuidance** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
 - 🧩 **CompiledSQLPreview** (`Component`) `[TRIVIAL]`
   - 📝 Present the exact Superset-generated compiled SQL preview, expose readiness or staleness clearly, and preserve readable recovery paths when preview generation fails. -->
   - 🏗️ Layer: UI -->
@@ -7411,6 +7488,8 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **jumpToMapping** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **askAiAboutPreview** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 🧩 **ValidationFindingsPanel** (`Component`) `[TRIVIAL]`
   - 📝 Present validation findings grouped by severity with explicit resolution and actionability signals. -->
   - 🏗️ Layer: UI -->
@@ -7439,6 +7518,16 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **getFindingResolutionNote** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **isFindingFocused** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getFindingFocusTarget** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **askAiAboutFinding** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **improveFindingGuidance** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getContextActionLabel** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 🧩 **LaunchConfirmationPanel** (`Component`) `[TRIVIAL]`
   - 📝 Summarize final execution context, surface launch blockers explicitly, and confirm only a gate-complete SQL Lab launch request. -->
   - 🏗️ Layer: UI -->
@@ -7499,15 +7588,21 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **saveManualOverride** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **isMappingFocused** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **askAiAboutMapping** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **improveMappingDraft** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **SourceIntakePanelUxTests** (`Module`)
   - 📝 Verify source intake entry paths, validation feedback, and submit payload behavior for US1.
   - 🏗️ Layer: UI
-- 📦 **DatasetReviewUs2UxTests** (`Module`)
-  - 📝 Verify US2 semantic field review and one-question clarification UX contracts.
-  - 🏗️ Layer: UI
 - 📦 **DatasetReviewUs3UxTests** (`Module`)
   - 📝 Verify US3 mapping review, Superset preview, and launch confirmation UX contracts.
   - 🏗️ Layer: UI
+- 📦 **DatasetReviewUs2WorkspaceUxTests** (`Module`)
+  - 📝 Verify US2 dataset review surfaces keep semantic review actionable, route clarification through AssistantChatPanel, and preserve explicit preview/mapping gates.
+  - 🏗️ Layer: UI
 - 📦 **ValidationFindingsPanelUxTests** (`Module`)
   - 📝 Verify grouped findings visibility, empty state, and remediation jump behavior for US1.
   - 🏗️ Layer: UI
@@ -7519,6 +7614,10 @@
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `derived`
   - 🔗 BINDS_TO -> `sidebar`
+  - 🔗 BINDS_TO -> `auth`
+  - 🔗 BINDS_TO -> `health_store`
+  - 🔗 DEPENDS_ON -> `SidebarNavigation`
+  - 🔗 DEPENDS_ON -> `Icon`
 - 📦 **Sidebar** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/lib/components/layout/Sidebar.svelte
   - 🏗️ Layer: Unknown
@@ -7544,6 +7643,12 @@
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `state`
   - 🔗 BINDS_TO -> `activity`
+  - 🔗 BINDS_TO -> `auth`
+  - 🔗 BINDS_TO -> `environmentContext`
+  - 🔗 DISPATCHES -> `taskDrawer`
+  - 🔗 DISPATCHES -> `assistantChat`
+  - 🔗 DEPENDS_ON -> `Icon`
+  - 🔗 DEPENDS_ON -> `LanguageSwitcher`
 - 📦 **TopNavbar** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/lib/components/layout/TopNavbar.svelte
   - 🏗️ Layer: Unknown
@@ -7586,7 +7691,9 @@
   - ⬅️ READS_FROM `app`
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `props`
-  - 🔗 DEPENDS_ON -> `page`
+  - 🔗 DEPENDS_ON -> `PageStore`
+  - 🔗 BINDS_TO -> `i18n`
+  - 🔗 DEPENDS_ON -> `Icon`
 - 📦 **Breadcrumbs** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/lib/components/layout/Breadcrumbs.svelte
   - 🏗️ Layer: Unknown
@@ -7681,6 +7788,10 @@
 - 📦 **ErrorPage** (`Page`)
   - 📝 Global error page displaying HTTP status and messages
   - 🏗️ Layer: UI
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
 - 📦 **RootLayoutConfig** (`Module`) `[TRIVIAL]`
   - 📝 Root layout configuration (SPA mode)
   - 🏗️ Layer: Infra
@@ -7688,6 +7799,9 @@
   - 📝 Redirect to preferred start page from profile settings with safe dashboards fallback.
   - 🏗️ Layer: UI
   - 🔒 Invariant: Redirect target resolves to one of /dashboards, /datasets, /reports.
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
 - 📦 **+page** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/routes/+page.svelte
   - 🏗️ Layer: Unknown
@@ -7703,6 +7817,7 @@
   - 📝 Root layout component that provides global UI structure (Sidebar, Navbar, Footer, TaskDrawer, Toasts).
   - 🏗️ Layer: UI (Layout)
   - 🔒 Invariant: All pages except /login are wrapped in ProtectedRoute.
+  - 🔗 IMPLEMENTS -> `NavigationContracts`
   - 🔗 DEPENDS_ON -> `Sidebar`
   - 🔗 DEPENDS_ON -> `TopNavbar`
   - 🔗 DEPENDS_ON -> `Footer`
@@ -7796,32 +7911,41 @@
   - ƒ **createSessionSummary** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
 - 🧩 **DatasetReviewWorkspace** (`Component`) `[TRIVIAL]`
-  - 📝 Main dataset review workspace coordinating session state, progressive recovery, semantic review, clarification, preview, and launch UX. -->
+  - 📝 Main dataset review workspace coordinating session state through a three-column chat-centric layout where the assistant is the primary review surface. -->
   - 🏗️ Layer: UI -->
   - 🔒 Invariant: Navigation away from dirty session state must require explicit confirmation. -->
   - ⬅️ READS_FROM `app`
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `state`
   - 🔗 BINDS_TO -> `api_module`
-  - 🔗 BINDS_TO -> `assistantChat`
-  - 🔗 BINDS_TO -> `taskDrawer`
+  - 🔗 BINDS_TO -> `AssistantChatPanel`
+  - 🔗 BINDS_TO -> `CompiledSQLPreview`
+  - 🔗 BINDS_TO -> `LaunchConfirmationPanel`
 - 📦 **+page** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/routes/datasets/review/[id]/+page.svelte
   - 🏗️ Layer: Unknown
-  - ƒ **normalizeJumpTarget** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
   - ƒ **getWorkspaceStateLabel** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-  - ƒ **getFallbackLabel** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
   - ƒ **getRecommendedActionLabel** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **getPrimaryActionCtaLabel** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **buildImportMilestones** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-  - ƒ **buildRecentActions** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
   - ƒ **buildWorkspaceLaunchBlockers** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **stringifyValue** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **buildAssistantContextPrompt** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **mergeCollectionItem** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **applySessionVersion** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **buildAssistantSeedPrompt** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **promptAssistantAbout** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **buildSessionUrl** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **loadSessionDetail** (`Function`) `[TRIVIAL]`
@@ -7838,32 +7962,22 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **exportArtifact** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-  - ƒ **handleFindingJump** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **startSummaryEdit** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **cancelSummaryEdit** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **saveSummaryDraft** (`Function`) `[TRIVIAL]`
+  - ƒ **handlePreviewUpdated** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **handleSemanticUpdated** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-  - ƒ **handleClarificationUpdated** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **handleExecutionMappingUpdated** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **handlePreviewUpdated** (`Function`) `[TRIVIAL]`
+  - ƒ **handleMappingUpdated** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **handleLaunchUpdated** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **handleSectionJump** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **handleAskAiContext** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **primaryActionHandler** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-  - ƒ **getPrimaryActionCtaLabel** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
 - 📦 **DatasetReviewWorkspaceUxTests** (`Module`)
-  - 📝 Verify US1-safe and US2-integrated dataset review workspace flow evidence for empty, load, import, semantics, clarification, and export behaviors.
+  - 📝 Verify the `027` dataset review workspace keeps assistant chat as the primary surface while preserving execution rail and resumable intake behavior.
   - 🏗️ Layer: UI
   - ƒ **createSessionDetail** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
@@ -7951,10 +8065,13 @@
     - 📝 Submits the local login form to the backend.
   - ƒ **handleADFSLogin** (`Function`) `[TRIVIAL]`
     - 📝 Redirects the user to the ADFS login endpoint.
-- 📦 **StorageIndexPage** (`Page`) `[TRIVIAL]`
+- 📦 **StorageIndexPage** (`Page`)
   - 📝 Redirect to the backups page as the default storage view.
   - 🏗️ Layer: Page
   - 🔒 Invariant: Always redirects to /storage/backups.
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
 - 📦 **StorageReposPage** (`Module`)
   - 📝 Dashboard management page for Git integration (moved from /git).
   - 🏗️ Layer: UI (Page)
@@ -8185,6 +8302,9 @@
   - 📝 Dashboard Detail View - Overview of charts and datasets linked to a dashboard
   - 🏗️ Layer: UI
   - 🔒 Invariant: Shows dashboard metadata, charts, and datasets for selected environment
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
   - 🔗 DEPENDS_ON -> `api_module`
 - 📦 **+page** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/routes/dashboards/[id]/+page.svelte
@@ -8262,13 +8382,15 @@
     - 📝 Submits role data (create or update).
   - ƒ **handleDeleteRole** (`Function`) `[TRIVIAL]`
     - 📝 Deletes a role after confirmation.
-- 🧩 **AdminUsersPage** (`Component`) `[TRIVIAL]`
+- 🧩 **AdminUsersPage** (`Component`)
   - 📝 UI for managing system users and their roles.
   - 🏗️ Layer: Feature
   - 🔒 Invariant: Only accessible by users with "admin:users" permission.
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `t`
   - ⬅️ READS_FROM `t`
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
   - 🔗 DEPENDS_ON -> `frontend.src.services.adminService`
   - 🔗 DEPENDS_ON -> `frontend.src.components.auth.ProtectedRoute`
   - ƒ **loadData** (`Function`) `[TRIVIAL]`
@@ -8446,16 +8568,26 @@
     - 📝 Navigates one level up in the directory structure.
   - ƒ **updateUploadCategory** (`Function`) `[TRIVIAL]`
     - 📝 Keeps upload category aligned with the currently viewed top-level folder.
-- 🧩 **MapperPage** (`Component`) `[TRIVIAL]`
+- 🧩 **MapperPage** (`Component`)
   - 📝 Page for the dataset column mapper tool.
   - 🏗️ Layer: UI
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `t`
-- 🧩 **DebugPage** (`Component`) `[TRIVIAL]`
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
+  - 🔗 DEPENDS_ON -> `MapperTool`
+  - 🔗 DEPENDS_ON -> `TaskRunner`
+- 🧩 **DebugPage** (`Component`)
   - 📝 Page for system diagnostics and debugging.
   - 🏗️ Layer: UI
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `t`
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
+  - 🔗 DEPENDS_ON -> `DebugTool`
+  - 🔗 DEPENDS_ON -> `TaskRunner`
 - 📦 **SettingsPage** (`Page`) `[CRITICAL]`
   - 📝 Consolidated Settings Page - All settings in one place with tabbed navigation
   - 🏗️ Layer: UI
@@ -8543,11 +8675,16 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **handleSave** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- 🧩 **ConnectionsSettingsPage** (`Component`) `[TRIVIAL]`
+- 🧩 **ConnectionsSettingsPage** (`Component`)
   - 📝 Page for managing database connection configurations.
   - 🏗️ Layer: UI
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `t`
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
+  - 🔗 DEPENDS_ON -> `ConnectionForm`
+  - 🔗 DEPENDS_ON -> `ConnectionList`
   - ƒ **handleSuccess** (`Function`) `[TRIVIAL]`
     - 📝 Refreshes the connection list after a successful creation.
 - 🧩 **GitSettingsPage** (`Component`) `[TRIVIAL]`
@@ -8557,6 +8694,9 @@
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `state`
   - ⬅️ READS_FROM `t`
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
   - ƒ **loadConfigs** (`Function`) `[TRIVIAL]`
     - 📝 Fetches existing git configurations.
   - ƒ **handleTest** (`Function`) `[TRIVIAL]`
@@ -8598,31 +8738,38 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **getEnvName** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- 🧩 **GitDashboardPage** (`Component`) `[TRIVIAL]`
+- 🧩 **GitDashboardPage** (`Component`)
   - 📝 Dashboard management page for Git integration.
   - 🏗️ Layer: Page
   - ⬅️ READS_FROM `lib`
   - ➡️ WRITES_TO `state`
   - ➡️ WRITES_TO `derived`
+  - 🔗 IMPLEMENTS -> `RoutePages`
+  - 🔗 IMPLEMENTS -> `PageContracts`
+  - 🔗 BINDS_TO -> `NavigationContracts`
+  - 🔗 DEPENDS_ON -> `RepositoryDashboardGrid`
+  - 🔗 BINDS_TO -> `environmentContextStore`
   - ƒ **fetchEnvironments** (`Function`) `[TRIVIAL]`
     - 📝 Fetches the list of deployment environments from the API.
   - ƒ **fetchDashboards** (`Function`) `[TRIVIAL]`
     - 📝 Fetches dashboards for a specific environment.
-- 🧩 **Dashboard** (`Component`) `[TRIVIAL]`
+- 🧩 **Dashboard** (`Component`)
   - 📝 Displays the list of available plugins and allows selecting one.
   - 🏗️ Layer: UI
   - ⬅️ READS_FROM `plugins`
+  - 🔗 IMPLEMENTS -> `PageContracts`
   - 🔗 DEPENDS_ON -> `stores`
   - ƒ **onMount** (`Function`) `[TRIVIAL]`
     - 📝 Fetch plugins when the component mounts.
   - ƒ **selectPlugin** (`Function`) `[TRIVIAL]`
     - 📝 Selects a plugin to display its form.
-- 🧩 **Settings** (`Component`) `[TRIVIAL]`
+- 🧩 **Settings** (`Component`)
   - 📝 The main settings page for the application, allowing management of environments and global settings.
   - 🏗️ Layer: UI
   - 🔒 Invariant: Settings changes must be saved to the backend.
   - ⬅️ READS_FROM `t`
   - ➡️ WRITES_TO `t`
+  - 🔗 IMPLEMENTS -> `PageContracts`
   - 🔗 CALLS -> `api.js`
   - ƒ **loadSettings** (`Function`) `[TRIVIAL]`
     - 📝 Loads settings from the backend.
@@ -8850,6 +8997,9 @@
   - ⬅️ READS_FROM `app`
   - ⬅️ READS_FROM `lib`
   - ⬅️ READS_FROM `t`
+  - 🔗 BINDS_TO -> `auth`
+  - 🔗 BINDS_TO -> `i18n`
+  - 🔗 DEPENDS_ON -> `LanguageSwitcher`
 - 📦 **Navbar** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for frontend/src/components/Navbar.svelte
   - 🏗️ Layer: Unknown
@@ -8877,7 +9027,7 @@
   - 📝 Displays transient notifications (toasts) in the bottom-right corner.
   - 🏗️ Layer: UI
   - ⬅️ READS_FROM `toasts`
-  - 🔗 DEPENDS_ON -> `frontend/src/lib/toasts.js`
+  - 🔗 BINDS_TO -> `toasts`
 - 🧩 **TaskRunner** (`Component`)
   - 📝 Connects to a WebSocket to display real-time logs for a running task with filtering support.
   - 🏗️ Layer: UI
@@ -9316,8 +9466,10 @@
   - 🔒 Invariant: All WebSocket connections must be properly cleaned up on disconnect.
   - 🔗 DEPENDS_ON -> `AppDependencies`
   - 🔗 DEPENDS_ON -> `ApiRoutesModule`
-  - 📦 **App** (`Global`) `[TRIVIAL]`
-    - 📝 The global FastAPI application instance.
+  - 📦 **FastAPI_App** (`Global`)
+    - 📝 Canonical FastAPI application instance for route, middleware, and websocket registration.
+    - 🔗 DEPENDS_ON -> `ApiRoutesModule`
+    - 🔗 BINDS_TO -> `API_Routes`
   - ƒ **ensure_initial_admin_user** (`Function`)
     - 📝 Ensures initial admin user exists when bootstrap env flags are enabled.
   - ƒ **startup_event** (`Function`)
@@ -9333,8 +9485,19 @@
   - ƒ **log_requests** (`Function`)
     - 📝 Middleware to log incoming HTTP requests and their response status.
     - 🔗 DEPENDS_ON -> `LoggerModule`
-  - ▦ **api_routes** (`Block`) `[TRIVIAL]`
-    - 📝 Register all application API routers.
+  - ▦ **API_Routes** (`Block`)
+    - 📝 Register all FastAPI route groups exposed by the application entrypoint.
+    - 🔗 DEPENDS_ON -> `FastAPI_App`
+    - 🔗 DEPENDS_ON -> `Route_Group_Contracts`
+    - 🔗 DEPENDS_ON -> `AuthApi`
+    - 🔗 DEPENDS_ON -> `AdminApi`
+    - 🔗 DEPENDS_ON -> `PluginsRouter`
+    - 🔗 DEPENDS_ON -> `TasksRouter`
+    - 🔗 DEPENDS_ON -> `SettingsRouter`
+    - 🔗 DEPENDS_ON -> `ConnectionsRouter`
+    - 🔗 DEPENDS_ON -> `ReportsRouter`
+    - 🔗 DEPENDS_ON -> `LlmRoutes`
+    - 🔗 DEPENDS_ON -> `CleanReleaseV2Api`
   - 📦 **api.include_routers** (`Action`) `[TRIVIAL]`
     - 📝 Registers all API routers with the FastAPI application.
     - 🏗️ Layer: API
@@ -9392,7 +9555,7 @@
     - 📝 Auto-detected function (orphan)
 - 📦 **SrcRoot** (`Module`) `[TRIVIAL]`
   - 📝 Canonical backend package root for application, scripts, and tests.
-- 📦 **backend.src.scripts.seed_superset_load_test** (`Module`)
+- 📦 **SeedSupersetLoadTestScript** (`Module`)
   - 📝 Creates randomized load-test data in Superset by cloning chart configurations and creating dashboards in target environments.
   - 🏗️ Layer: Scripts
   - 🔒 Invariant: Created chart and dashboard names are globally unique for one script run.
@@ -9416,12 +9579,12 @@
   - 📝 Tests and inspects dataset-to-dashboard relationship responses from Superset API.
   - ƒ **test_dashboard_dataset_relations** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- 📦 **backend.src.scripts.clean_release_tui** (`Module`)
+- 📦 **CleanReleaseTuiScript** (`Module`)
   - 📝 Interactive terminal interface for Enterprise Clean Release compliance validation.
   - 🏗️ Layer: UI
   - 🔒 Invariant: TUI refuses startup in non-TTY environments; headless flow is CLI/API only.
-  - 🔗 DEPENDS_ON -> `backend.src.services.clean_release.compliance_orchestrator`
-  - 🔗 DEPENDS_ON -> `backend.src.services.clean_release.repository`
+  - 🔗 DEPENDS_ON -> `compliance_orchestrator`
+  - 🔗 DEPENDS_ON -> `repository`
   - ℂ **TuiFacadeAdapter** (`Class`) `[TRIVIAL]`
     - 📝 Thin TUI adapter that routes business mutations through application services.
   - ℂ **CleanReleaseTUI** (`Class`) `[TRIVIAL]`
@@ -9482,7 +9645,7 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **main** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- 📦 **backend.src.scripts.migrate_sqlite_to_postgres** (`Module`)
+- 📦 **MigrateSqliteToPostgresScript** (`Module`)
   - 📝 Migrates legacy config and task history from SQLite/file storage to PostgreSQL.
   - 🏗️ Layer: Scripts
   - 🔒 Invariant: Script is idempotent for task_records and app_configurations.
@@ -9503,7 +9666,7 @@
     - 📝 Orchestrates migration from SQLite/file to PostgreSQL.
   - ƒ **main** (`Function`) `[TRIVIAL]`
     - 📝 CLI entrypoint.
-- 📦 **backend.src.scripts.clean_release_cli** (`Module`)
+- 📦 **CleanReleaseCliScript** (`Module`)
   - 📝 Provide headless CLI commands for candidate registration, artifact import and manifest build.
   - 🏗️ Layer: Scripts
   - ƒ **build_parser** (`Function`) `[TRIVIAL]`
@@ -9566,15 +9729,15 @@
     - 🔗 CALLS -> `ensure_encryption_key`
     - 🔗 CALLS -> `init_db`
     - 🔗 CALLS -> `seed_permissions`
-- 📦 **backend.src.scripts.create_admin** (`Module`)
+- 📦 **CreateAdminScript** (`Module`)
   - 📝 CLI tool for creating the initial admin user.
   - 🏗️ Layer: Scripts
   - 🔒 Invariant: Admin user must have the "Admin" role.
   - ƒ **create_admin** (`Function`) `[TRIVIAL]`
     - 📝 Creates an admin user and necessary roles/permissions.
-- 📦 **src.scripts** (`Package`) `[TRIVIAL]`
+- 📦 **ScriptsPackage** (`Package`) `[TRIVIAL]`
   - 📝 Script entrypoint package root.
-- 📦 **backend.src.schemas.health** (`Module`)
+- 📦 **HealthSchemas** (`Module`)
   - 📝 Pydantic schemas for dashboard health summary.
   - 🏗️ Layer: Domain
   - ℂ **DashboardHealthItem** (`Class`) `[TRIVIAL]`
@@ -9602,7 +9765,7 @@
   - ℂ **DatasetRunContextDto** (`Class`) `[TRIVIAL]`
   - ℂ **SessionSummary** (`Class`) `[TRIVIAL]`
   - ℂ **SessionDetail** (`Class`) `[TRIVIAL]`
-- 📦 **backend.src.schemas.settings** (`Module`)
+- 📦 **SettingsSchemas** (`Module`)
   - 📝 Pydantic schemas for application settings and automation policies.
   - 🏗️ Layer: Domain
   - ℂ **NotificationChannel** (`Class`) `[TRIVIAL]`
@@ -9615,7 +9778,7 @@
     - 📝 Schema for updating an existing validation policy.
   - ℂ **ValidationPolicyResponse** (`Class`) `[TRIVIAL]`
     - 📝 Schema for validation policy response data.
-- 📦 **backend.src.schemas.auth** (`Module`)
+- 📦 **AuthSchemas** (`Module`)
   - 📝 Pydantic schemas for authentication requests and responses.
   - 🏗️ Layer: API
   - 🔒 Invariant: Sensitive fields like password must not be included in response schemas.
@@ -9644,7 +9807,7 @@
     - 📝 Schema for updating an existing user.
   - ℂ **User** (`Class`) `[CRITICAL]`
     - 📝 Schema for user data in API responses.
-- 📦 **backend.src.schemas.profile** (`Module`)
+- 📦 **ProfileSchemas** (`Module`)
   - 📝 Defines API schemas for profile preference persistence, security read-only snapshot, and Superset account lookup.
   - 🏗️ Layer: API
   - 🔒 Invariant: Schema shapes stay stable for profile UI states and backend preference contracts.
@@ -9665,7 +9828,7 @@
     - 📝 Canonical account candidate projected from Superset users payload.
   - ℂ **SupersetAccountLookupResponse** (`Class`)
     - 📝 Response envelope for Superset account lookup (success or degraded mode).
-- 📦 **src.schemas** (`Package`) `[TRIVIAL]`
+- 📦 **SchemasPackage** (`Package`) `[TRIVIAL]`
   - 📝 API schema package root.
 - 📦 **TestSettingsAndHealthSchemas** (`Module`)
   - 📝 Regression tests for settings and health schema contracts updated in 026 fix batch.
@@ -10051,10 +10214,15 @@
   - ƒ **_ensure_filter_source_enum_values** (`Function`)
     - 📝 Adds missing FilterSource enum values to the PostgreSQL native filtersource type.
     - 🔗 DEPENDS_ON -> `engine`
+  - ƒ **_ensure_dataset_review_session_columns** (`Function`)
+    - 📝 Apply additive schema upgrades for dataset review persistence required by optimistic-lock and recovery metadata semantics.
+    - 🔗 DEPENDS_ON -> `DatasetReviewSession`
+    - 🔗 DEPENDS_ON -> `ImportedFilter`
   - ƒ **init_db** (`Function`)
     - 📝 Initializes the database by creating all tables.
     - 🔗 CALLS -> `ensure_connection_configs_table`
     - 🔗 CALLS -> `_ensure_filter_source_enum_values`
+    - 🔗 CALLS -> `_ensure_dataset_review_session_columns`
   - ƒ **get_db** (`Function`)
     - 📝 Dependency for getting a database session.
     - 🔗 DEPENDS_ON -> `SessionLocal`
@@ -10386,6 +10554,12 @@
   - 🔗 DEPENDS_ON -> `ImportedFilter`
   - 🔗 DEPENDS_ON -> `TemplateVariable`
   - ▦ **SupersetContextExtractor.imports** (`Block`) `[TRIVIAL]`
+  - ƒ **mask_pii_value** (`Function`) `[TRIVIAL]`
+    - 📝 Redact likely sensitive identifiers while preserving structural hints for assistant-facing dataset-review context.
+  - ƒ **sanitize_imported_filter_for_assistant** (`Function`) `[TRIVIAL]`
+    - 📝 Build assistant-safe imported-filter payload with raw-value redaction metadata when sensitive tokens are detected.
+  - ƒ **_mask_sensitive_text** (`Function`) `[TRIVIAL]`
+    - 📝 Redact likely PII substrings from one string while preserving non-sensitive delimiters and token shape.
   - ℂ **SupersetParsedContext** (`Class`) `[TRIVIAL]`
     - 📝 Normalized output of Superset link parsing for session intake and recovery.
   - ℂ **SupersetContextExtractor** (`Class`)
@@ -10435,6 +10609,14 @@
       - 📝 Extract a deterministic primary identifier from a Jinja expression without executing it.
     - ƒ **SupersetContextExtractor._normalize_default_literal** (`Function`) `[TRIVIAL]`
       - 📝 Normalize literal default fragments from template helper calls into JSON-safe values.
+  - ƒ **_replace_email** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_replace_uuid** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_replace_long_digits** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_replace_mixed_identifier** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **parse_superset_link** (`Function`) `[TRIVIAL]`
@@ -10993,12 +11175,12 @@
   - 🏗️ Layer: Core
   - 🔒 Invariant: Each TaskLogger instance is bound to a specific task_id and default source.
   - 🔗 DEPENDS_ON -> `TaskManager`
-  - 🔗 CALLS -> `_add_log`
+  - 🔗 DEPENDS_ON -> `EventBus`
   - ℂ **TaskLogger** (`Class`) `[TRIVIAL]`
     - 📝 A wrapper around TaskManager._add_log that carries task_id and source context.
     - 🔒 Invariant: All log calls include the task_id and source.
     - 🔗 DEPENDS_ON -> `TaskManager`
-    - 🔗 CALLS -> `_add_log`
+    - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **__init__** (`Function`) `[TRIVIAL]`
       - 📝 Initialize the TaskLogger with task context.
     - ƒ **with_source** (`Function`) `[TRIVIAL]`
@@ -11019,6 +11201,8 @@
   - 📝 Handles the persistence of tasks using SQLAlchemy and the tasks.db database.
   - 🏗️ Layer: Core
   - 🔒 Invariant: Database schema must match the TaskRecord model structure.
+  - 🔗 DEPENDS_ON -> `TaskManager`
+  - 🔗 DEPENDS_ON -> `TaskGraph`
   - 🔗 DEPENDS_ON -> `TasksSessionLocal`
   - ℂ **TaskPersistenceService** (`Class`) `[CRITICAL]`
     - 📝 Provides methods to save, load, and delete task records in tasks.db using SQLAlchemy models.
@@ -11026,6 +11210,8 @@
     - 🔗 DEPENDS_ON -> `TasksSessionLocal`
     - 🔗 DEPENDS_ON -> `TaskRecord`
     - 🔗 DEPENDS_ON -> `Environment`
+    - 🔗 DEPENDS_ON -> `TaskManager`
+    - 🔗 DEPENDS_ON -> `TaskGraph`
     - ƒ **_json_load_if_needed** (`Function`) `[TRIVIAL]`
       - 📝 Safely load JSON strings from DB if necessary
     - ƒ **_parse_datetime** (`Function`) `[TRIVIAL]`
@@ -11053,6 +11239,8 @@
     - 🔒 Invariant: Log entries are batch-inserted for performance.
     - 🔗 DEPENDS_ON -> `TaskLogRecord`
     - 🔗 DEPENDS_ON -> `TasksSessionLocal`
+    - 🔗 DEPENDS_ON -> `TaskManager`
+    - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **__init__** (`Function`)
       - 📝 Initializes the TaskLogPersistenceService
     - ƒ **add_logs** (`Function`)
@@ -11080,13 +11268,17 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **json_serializable** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- 📦 **TaskManager** (`Module`) `[CRITICAL]`
+- 📦 **TaskManagerModule** (`Module`) `[CRITICAL]`
   - 📝 Manages the lifecycle of tasks, including their creation, execution, and state tracking. It uses a thread pool to run plugins asynchronously.
   - 🏗️ Layer: Core
   - 🔒 Invariant: Task IDs are unique.
   - 🔗 DEPENDS_ON -> `PluginLoader`
   - 🔗 DEPENDS_ON -> `TaskPersistenceService`
   - 🔗 DEPENDS_ON -> `TaskLogPersistenceService`
+  - 🔗 DEPENDS_ON -> `TaskContext`
+  - 🔗 DEPENDS_ON -> `TaskGraph`
+  - 🔗 DEPENDS_ON -> `JobLifecycle`
+  - 🔗 DEPENDS_ON -> `EventBus`
   - ℂ **TaskManager** (`Class`) `[CRITICAL]`
     - 📝 Manages the lifecycle of tasks, including their creation, execution, and state tracking.
     - 🏗️ Layer: Core
@@ -11094,67 +11286,114 @@
     - 🔗 DEPENDS_ON -> `TaskPersistenceService`
     - 🔗 DEPENDS_ON -> `TaskLogPersistenceService`
     - 🔗 DEPENDS_ON -> `PluginLoader`
+    - 🔗 DEPENDS_ON -> `TaskContext`
+    - 🔗 DEPENDS_ON -> `TaskGraph`
+    - 🔗 DEPENDS_ON -> `JobLifecycle`
+    - 🔗 DEPENDS_ON -> `EventBus`
+    - ▦ **TaskGraph** (`Block`) `[CRITICAL]`
+      - 📝 Represents the in-memory task dependency graph spanning task registry nodes, paused futures, and persistence-backed hydration.
+      - 🔒 Invariant: Registry membership is keyed by unique task id and survives log streaming side channels.
+      - 🔗 DEPENDS_ON -> `Task`
+      - 🔗 DEPENDS_ON -> `TaskPersistenceService`
+    - ▦ **EventBus** (`Block`) `[CRITICAL]`
+      - 📝 Coordinates task-scoped log buffering, persistence flushes, and subscriber fan-out for real-time observers.
+      - 🔒 Invariant: Buffered logs are retried on persistence failure and every subscriber receives only task-scoped events.
+      - 🔗 DEPENDS_ON -> `LogEntry`
+      - 🔗 DEPENDS_ON -> `TaskLogPersistenceService`
+    - ▦ **JobLifecycle** (`Block`) `[CRITICAL]`
+      - 📝 Encodes task creation, execution, pause/resume, and completion transitions for plugin-backed jobs.
+      - 🔒 Invariant: A task cannot be resumed from a waiting state unless a matching future exists or a new wait future is created.
+      - 🔗 DEPENDS_ON -> `TaskGraph`
+      - 🔗 DEPENDS_ON -> `EventBus`
+      - 🔗 DEPENDS_ON -> `TaskContext`
+      - 🔗 DEPENDS_ON -> `PluginLoader`
     - ƒ **__init__** (`Function`) `[CRITICAL]`
       - 📝 Initialize the TaskManager with dependencies.
       - 🔗 CALLS -> `TaskPersistenceService.load_tasks`
+      - 🔗 DEPENDS_ON -> `TaskGraph`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **_flusher_loop** (`Function`)
       - 📝 Background thread that periodically flushes log buffer to database.
       - 🔗 CALLS -> `TaskManager._flush_logs`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **_flush_logs** (`Function`)
       - 📝 Flush all buffered logs to the database.
       - 🔗 CALLS -> `TaskLogPersistenceService.add_logs`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **_flush_task_logs** (`Function`)
       - 📝 Flush logs for a specific task immediately.
       - 🔗 CALLS -> `TaskLogPersistenceService.add_logs`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **create_task** (`Function`)
       - 📝 Creates and queues a new task for execution.
       - 🔗 CALLS -> `TaskPersistenceService.persist_task`
+      - 🔗 DEPENDS_ON -> `JobLifecycle`
+      - 🔗 DEPENDS_ON -> `TaskGraph`
     - ƒ **_run_task** (`Function`)
       - 📝 Internal method to execute a task with TaskContext support.
       - 🔗 CALLS -> `TaskPersistenceService.persist_task`
+      - 🔗 DEPENDS_ON -> `JobLifecycle`
+      - 🔗 DEPENDS_ON -> `TaskContext`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **resolve_task** (`Function`)
       - 📝 Resumes a task that is awaiting mapping.
       - 🔗 CALLS -> `TaskPersistenceService.persist_task`
+      - 🔗 DEPENDS_ON -> `JobLifecycle`
     - ƒ **wait_for_resolution** (`Function`)
       - 📝 Pauses execution and waits for a resolution signal.
       - 🔗 CALLS -> `TaskPersistenceService.persist_task`
+      - 🔗 DEPENDS_ON -> `JobLifecycle`
     - ƒ **wait_for_input** (`Function`)
       - 📝 Pauses execution and waits for user input.
-      - 🔗 CALLS -> `asyncio.AbstractEventLoop.create_future`
+      - 🔗 DEPENDS_ON -> `JobLifecycle`
     - ƒ **get_task** (`Function`)
       - 📝 Retrieves a task by its ID.
+      - 🔗 DEPENDS_ON -> `TaskGraph`
     - ƒ **get_all_tasks** (`Function`)
       - 📝 Retrieves all registered tasks.
+      - 🔗 DEPENDS_ON -> `TaskGraph`
     - ƒ **get_tasks** (`Function`)
       - 📝 Retrieves tasks with pagination and optional status filter.
+      - 🔗 DEPENDS_ON -> `TaskGraph`
     - ƒ **get_task_logs** (`Function`)
       - 📝 Retrieves logs for a specific task (from memory for running, persistence for completed).
       - 🔗 CALLS -> `TaskLogPersistenceService.get_logs`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **get_task_log_stats** (`Function`)
       - 📝 Get statistics about logs for a task.
       - 🔗 CALLS -> `TaskLogPersistenceService.get_log_stats`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **get_task_log_sources** (`Function`)
       - 📝 Get unique sources for a task's logs.
       - 🔗 CALLS -> `TaskLogPersistenceService.get_sources`
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **_add_log** (`Function`)
       - 📝 Adds a log entry to a task buffer and notifies subscribers.
       - 🔗 CALLS -> `should_log_task_level`
+      - 🔗 DISPATCHES -> `EventBus`
     - ƒ **subscribe_logs** (`Function`)
       - 📝 Subscribes to real-time logs for a task.
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **unsubscribe_logs** (`Function`)
       - 📝 Unsubscribes from real-time logs for a task.
+      - 🔗 DEPENDS_ON -> `EventBus`
     - ƒ **load_persisted_tasks** (`Function`)
       - 📝 Load persisted tasks using persistence service.
       - 🔗 CALLS -> `TaskPersistenceService.load_tasks`
+      - 🔗 DEPENDS_ON -> `TaskGraph`
     - ƒ **await_input** (`Function`)
       - 📝 Transition a task to AWAITING_INPUT state with input request.
       - 🔗 CALLS -> `TaskPersistenceService.persist_task`
+      - 🔗 DEPENDS_ON -> `JobLifecycle`
     - ƒ **resume_task_with_password** (`Function`)
       - 📝 Resume a task that is awaiting input with provided passwords.
       - 🔗 CALLS -> `TaskPersistenceService.persist_task`
+      - 🔗 DEPENDS_ON -> `JobLifecycle`
     - ƒ **clear_tasks** (`Function`)
       - 📝 Clears tasks based on status filter (also deletes associated logs).
       - 🔗 CALLS -> `TaskPersistenceService.delete_tasks`
+      - 🔗 DEPENDS_ON -> `TaskGraph`
+      - 🔗 DEPENDS_ON -> `EventBus`
   - ƒ **sort_key** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
 - 📦 **TaskManagerModels** (`Module`)
@@ -11165,19 +11404,26 @@
     - 📝 Defines the possible states a task can be in during its lifecycle.
   - 📦 **LogLevel** (`Enum`) `[TRIVIAL]`
     - 📝 Defines the possible log levels for task logging.
+    - 🔗 DEPENDS_ON -> `LogEntry`
   - ℂ **LogEntry** (`Class`) `[TRIVIAL]`
     - 📝 A Pydantic model representing a single, structured log entry associated with a task.
     - 🔒 Invariant: Each log entry has a unique timestamp and source.
     - 🔗 DEPENDS_ON -> `LogLevel`
+    - 🔗 DEPENDS_ON -> `Task`
   - ℂ **TaskLog** (`Class`)
     - 📝 A Pydantic model representing a persisted log entry from the database.
+    - 🔗 DEPENDS_ON -> `TaskLogRecord`
   - ℂ **LogFilter** (`Class`) `[TRIVIAL]`
     - 📝 Filter parameters for querying task logs.
+    - 🔗 DEPENDS_ON -> `TaskManager`
   - ℂ **LogStats** (`Class`) `[TRIVIAL]`
     - 📝 Statistics about log entries for a task.
+    - 🔗 DEPENDS_ON -> `TaskLog`
   - ℂ **Task** (`Class`)
     - 📝 A Pydantic model representing a single execution instance of a plugin, including its status, parameters, and logs.
     - 🔗 DEPENDS_ON -> `TaskStatus`
+    - 🔗 DEPENDS_ON -> `LogEntry`
+    - 🔗 DEPENDS_ON -> `TaskManager`
     - ƒ **__init__** (`Function`) `[TRIVIAL]`
       - 📝 Initializes the Task model and validates input_request for AWAITING_INPUT status.
 - 📦 **TaskCleanupModule** (`Module`)
@@ -11197,12 +11443,13 @@
   - 🔒 Invariant: Package exports stay aligned with manager and models contracts.
   - 🔗 DEPENDS_ON -> `TaskManagerModels`
   - 🔗 DEPENDS_ON -> `TaskManagerModule`
-  - 🔗 DEPENDS_ON -> `backend.src.core.task_manager.manager.TaskManager`
+  - 🔗 DEPENDS_ON -> `TaskManager`
 - 📦 **TaskContextModule** (`Module`) `[CRITICAL]`
   - 📝 Provides execution context passed to plugins during task execution.
   - 🏗️ Layer: Core
   - 🔒 Invariant: Each TaskContext is bound to a single task execution.
   - 🔗 DEPENDS_ON -> `TaskLoggerModule`
+  - 🔗 DEPENDS_ON -> `TaskManager`
   - ℂ **TaskContext** (`Class`) `[CRITICAL]`
     - 📝 A container passed to plugin.execute() providing the logger and other task-specific utilities.
     - 🔒 Invariant: logger is always a valid TaskLogger instance.
@@ -11277,24 +11524,45 @@
     - 🔗 CALLS -> `AuthService.create_session`
 - 📦 **src.api** (`Package`) `[TRIVIAL]`
   - 📝 Backend API package root.
-- 📦 **router** (`Global`) `[TRIVIAL]`
-  - 📝 APIRouter instance for LLM routes.
-- ƒ **_is_valid_runtime_api_key** (`Function`) `[TRIVIAL]`
-  - 📝 Validate decrypted runtime API key presence/shape.
-- ƒ **get_providers** (`Function`) `[TRIVIAL]`
-  - 📝 Retrieve all LLM provider configurations.
-- ƒ **get_llm_status** (`Function`) `[TRIVIAL]`
-  - 📝 Returns whether LLM runtime is configured for dashboard validation.
-- ƒ **create_provider** (`Function`) `[TRIVIAL]`
-  - 📝 Create a new LLM provider configuration.
-- ƒ **update_provider** (`Function`) `[TRIVIAL]`
-  - 📝 Update an existing LLM provider configuration.
-- ƒ **delete_provider** (`Function`) `[TRIVIAL]`
-  - 📝 Delete an LLM provider configuration.
-- ƒ **test_connection** (`Function`) `[TRIVIAL]`
-  - 📝 Test connection to an LLM provider.
-- ƒ **test_provider_config** (`Function`) `[TRIVIAL]`
-  - 📝 Test connection with a provided configuration (not yet saved).
+- 📦 **LlmRoutes** (`Module`)
+  - 📝 API routes for LLM provider configuration and management.
+  - 🏗️ Layer: UI (API)
+  - 🔗 DEPENDS_ON -> `LLMProviderService`
+  - 🔗 DEPENDS_ON -> `LLMProviderConfig`
+  - 🔗 DEPENDS_ON -> `get_current_user`
+  - 🔗 DEPENDS_ON -> `get_db`
+  - 📦 **router** (`Global`) `[TRIVIAL]`
+    - 📝 APIRouter instance for LLM routes.
+  - ƒ **_is_valid_runtime_api_key** (`Function`) `[TRIVIAL]`
+    - 📝 Validate decrypted runtime API key presence/shape.
+    - 🔗 BINDS_TO -> `LlmRoutes`
+  - ƒ **get_providers** (`Function`) `[TRIVIAL]`
+    - 📝 Retrieve all LLM provider configurations.
+    - 🔗 CALLS -> `LLMProviderService`
+    - 🔗 DEPENDS_ON -> `LLMProviderConfig`
+  - ƒ **get_llm_status** (`Function`) `[TRIVIAL]`
+    - 📝 Returns whether LLM runtime is configured for dashboard validation.
+    - 🔗 CALLS -> `LLMProviderService`
+    - 🔗 CALLS -> `_is_valid_runtime_api_key`
+  - ƒ **create_provider** (`Function`) `[TRIVIAL]`
+    - 📝 Create a new LLM provider configuration.
+    - 🔗 CALLS -> `LLMProviderService`
+    - 🔗 DEPENDS_ON -> `LLMProviderConfig`
+  - ƒ **update_provider** (`Function`) `[TRIVIAL]`
+    - 📝 Update an existing LLM provider configuration.
+    - 🔗 CALLS -> `LLMProviderService`
+    - 🔗 DEPENDS_ON -> `LLMProviderConfig`
+  - ƒ **delete_provider** (`Function`) `[TRIVIAL]`
+    - 📝 Delete an LLM provider configuration.
+    - 🔗 CALLS -> `LLMProviderService`
+  - ƒ **test_connection** (`Function`) `[TRIVIAL]`
+    - 📝 Test connection to an LLM provider.
+    - 🔗 CALLS -> `LLMProviderService`
+    - 🔗 DEPENDS_ON -> `LLMClient`
+  - ƒ **test_provider_config** (`Function`) `[TRIVIAL]`
+    - 📝 Test connection with a provided configuration (not yet saved).
+    - 🔗 DEPENDS_ON -> `LLMClient`
+    - 🔗 DEPENDS_ON -> `LLMProviderConfig`
 - 📦 **DatasetsApi** (`Module`)
   - 📝 API endpoints for the Dataset Hub - listing datasets with mapping progress
   - 🏗️ Layer: API
@@ -11556,6 +11824,16 @@
   - ƒ **_serialize_session_detail** (`Function`) `[TRIVIAL]`
     - 📝 Map SQLAlchemy session aggregate root into stable API detail DTO.
     - 🔗 DEPENDS_ON -> `SessionDetail`
+  - ƒ **_require_session_version_header** (`Function`) `[TRIVIAL]`
+    - 📝 Read the optimistic-lock session version header required by dataset review mutation endpoints.
+  - ƒ **_enforce_session_version** (`Function`)
+    - 📝 Convert repository optimistic-lock conflicts into deterministic HTTP 409 responses.
+    - 🔗 DEPENDS_ON -> `DatasetReviewSessionRepository`
+  - ƒ **_prepare_owned_session_mutation** (`Function`)
+    - 📝 Resolve owner-scoped mutation session and enforce optimistic-lock version before changing dataset review state.
+  - ƒ **_commit_owned_session_mutation** (`Function`)
+    - 📝 Centralize dataset-review session version bumping and commit semantics for owner-scoped mutation endpoints.
+    - 🔗 DEPENDS_ON -> `DatasetReviewSessionRepository`
   - ƒ **_serialize_semantic_field** (`Function`) `[TRIVIAL]`
     - 📝 Map one semantic field aggregate into stable field-level DTO output.
     - 🔗 DEPENDS_ON -> `SemanticFieldEntryDto`
@@ -11565,6 +11843,9 @@
   - ƒ **_serialize_clarification_state** (`Function`) `[TRIVIAL]`
     - 📝 Convert clarification engine state into stable API response payload.
     - 🔗 DEPENDS_ON -> `ClarificationStateResponse`
+  - ƒ **_serialize_empty_clarification_state** (`Function`) `[TRIVIAL]`
+    - 📝 Return a stable empty clarification payload for sessions that have not started clarification yet.
+    - 🔗 DEPENDS_ON -> `ClarificationStateResponse`
   - ƒ **_get_owned_session_or_404** (`Function`)
     - 📝 Resolve one session for current user or collaborator scope, returning 404 when inaccessible.
     - 🔗 CALLS -> `load_detail`
@@ -11596,6 +11877,9 @@
   - ƒ **_serialize_execution_mapping** (`Function`) `[TRIVIAL]`
     - 📝 Map one persisted execution mapping into stable API DTO output.
     - 🔗 DEPENDS_ON -> `ExecutionMappingDto`
+  - ƒ **_serialize_preview** (`Function`) `[TRIVIAL]`
+    - 📝 Map one persisted preview snapshot into stable API DTO output and surface the refreshed session version for follow-up optimistic-lock mutations.
+    - 🔗 DEPENDS_ON -> `CompiledPreviewDto`
   - ƒ **_serialize_run_context** (`Function`) `[TRIVIAL]`
     - 📝 Map one persisted launch run context into stable API DTO output for SQL Lab handoff confirmation.
     - 🔗 DEPENDS_ON -> `DatasetRunContextDto`
@@ -11630,7 +11914,7 @@
     - 📝 Export validation findings for the current session in JSON or Markdown form.
     - 🔗 DEPENDS_ON -> `DatasetReviewSession`
   - ƒ **get_clarification_state** (`Function`)
-    - 📝 Return the current clarification session summary and one active question payload.
+    - 📝 Return the current clarification session summary and one active question payload, or an empty state when clarification has not started.
     - 🔗 CALLS -> `build_question_payload:Function`
   - ƒ **resume_clarification** (`Function`)
     - 📝 Resume clarification mode on the highest-priority unresolved question for an owned session.
@@ -11714,10 +11998,19 @@
 - 📦 **PluginsRouter** (`Module`)
   - 📝 Defines the FastAPI router for plugin-related endpoints, allowing clients to list available plugins.
   - 🏗️ Layer: UI (API)
+  - 🔗 DEPENDS_ON -> `PluginConfig`
+  - 🔗 DEPENDS_ON -> `get_plugin_loader`
+  - 🔗 BINDS_TO -> `API_Routes`
   - ƒ **list_plugins** (`Function`) `[TRIVIAL]`
     - 📝 Retrieve a list of all available plugins.
+    - 🔗 CALLS -> `get_plugin_loader`
+    - 🔗 DEPENDS_ON -> `PluginConfig`
 - 📦 **CleanReleaseV2Api** (`Module`)
   - 📝 Redesigned clean release API for headless candidate lifecycle.
+  - 🏗️ Layer: UI (API)
+  - 🔗 DEPENDS_ON -> `CleanReleaseRepository`
+  - 🔗 CALLS -> `approve_candidate`
+  - 🔗 CALLS -> `publish_candidate`
   - ℂ **ApprovalRequest** (`Class`) `[TRIVIAL]`
     - 📝 Schema for approval request payload.
   - ℂ **PublishRequest** (`Class`) `[TRIVIAL]`
@@ -11727,6 +12020,7 @@
   - ƒ **register_candidate** (`Function`)
     - 📝 Register a new release candidate.
     - 🔗 CALLS -> `CleanReleaseRepository.save_candidate`
+    - 🔗 DEPENDS_ON -> `CandidateDTO`
   - ƒ **import_artifacts** (`Function`)
     - 📝 Associate artifacts with a release candidate.
     - 🔗 CALLS -> `CleanReleaseRepository.get_candidate`
@@ -12002,6 +12296,24 @@
     - 📝 Build current-user tool catalog for LLM planner with operation contracts and defaults.
   - ƒ **_coerce_intent_entities** (`Function`) `[TRIVIAL]`
     - 📝 Normalize intent entity value types from LLM output to route-compatible values.
+  - ƒ **_serialize_dataset_review_context** (`Function`)
+    - 📝 Build assistant-safe dataset-review context snapshot with masked imported-filter payloads for session-scoped assistant routing.
+    - 🔗 DEPENDS_ON -> `DatasetReviewSession`
+  - ƒ **_load_dataset_review_context** (`Function`)
+    - 📝 Load owner-scoped dataset-review context for assistant planning and grounded response generation.
+    - 🔗 DEPENDS_ON -> `DatasetReviewSessionRepository`
+  - ƒ **_extract_dataset_review_target** (`Function`) `[TRIVIAL]`
+    - 📝 Extract structured dataset-review focus target hints embedded in assistant prompts.
+  - ƒ **_match_dataset_review_field** (`Function`) `[TRIVIAL]`
+    - 📝 Resolve one semantic field from assistant-visible context by id or user-visible label.
+  - ƒ **_extract_quoted_segment** (`Function`) `[TRIVIAL]`
+    - 📝 Extract one quoted assistant command segment after a label token.
+  - ƒ **_dataset_review_conflict_http_exception** (`Function`) `[TRIVIAL]`
+    - 📝 Convert dataset-review optimistic-lock conflicts into shared 409 assistant semantics.
+  - ƒ **_plan_dataset_review_intent** (`Function`)
+    - 📝 Parse session-scoped dataset-review assistant commands before falling back to generic assistant tool routing.
+  - ƒ **_dispatch_dataset_review_intent** (`Function`)
+    - 📝 Route confirmed dataset-review assistant intents through existing backend dataset-review APIs and orchestration boundaries.
   - ƒ **_confirmation_summary** (`Function`)
     - 📝 Build human-readable confirmation prompt for an intent before execution.
   - ƒ **_clarification_text_for_intent** (`Function`) `[TRIVIAL]`
@@ -12107,6 +12419,7 @@
   - 🔗 DEPENDS_ON -> `has_permission:Function`
   - ƒ **_parse_csv_enum_list** (`Function`) `[TRIVIAL]`
     - 📝 Parse comma-separated query value into enum list.
+    - 🔗 BINDS_TO -> `ReportsRouter`
   - ƒ **list_reports** (`Function`) `[TRIVIAL]`
     - 📝 Return paginated unified reports list.
     - 🔗 CALLS -> `_parse_csv_enum_list:Function`
@@ -12114,6 +12427,7 @@
     - 🔗 DEPENDS_ON -> `ReportsService:Class`
   - ƒ **get_report_detail** (`Function`) `[TRIVIAL]`
     - 📝 Return one normalized report detail with diagnostics and next actions.
+    - 🔗 CALLS -> `ReportsService:Class`
 - 📦 **ProfileApiModule** (`Module`) `[CRITICAL]`
   - 📝 Exposes self-scoped profile preference endpoints and environment-based Superset account lookup.
   - 🏗️ Layer: API
@@ -12138,6 +12452,15 @@
   - 🏗️ Layer: API
   - 🔒 Invariant: Only names listed in __all__ are importable via __getattr__.
   - 🔗 CALLS -> `ApiRoutesGetAttr`
+  - 🔗 BINDS_TO -> `Route_Group_Contracts`
+  - ▦ **Route_Group_Contracts** (`Block`)
+    - 📝 Declare the canonical route-module registry used by lazy imports and app router inclusion.
+    - 🔗 DEPENDS_ON -> `PluginsRouter`
+    - 🔗 DEPENDS_ON -> `TasksRouter`
+    - 🔗 DEPENDS_ON -> `SettingsRouter`
+    - 🔗 DEPENDS_ON -> `ConnectionsRouter`
+    - 🔗 DEPENDS_ON -> `ReportsRouter`
+    - 🔗 DEPENDS_ON -> `LlmRoutes`
   - ƒ **ApiRoutesGetAttr** (`Function`)
     - 📝 Lazily import route module by attribute name.
     - 🔗 DEPENDS_ON -> `ApiRoutesModule`
@@ -12151,22 +12474,36 @@
   - 🔗 DEPENDS_ON -> `LLMProviderService`
   - ƒ **create_task** (`Function`)
     - 📝 Create and start a new task for a given plugin.
+    - 🔗 CALLS -> `TaskManager`
+    - 🔗 DEPENDS_ON -> `ConfigManager`
+    - 🔗 DEPENDS_ON -> `LLMProviderService`
   - ƒ **list_tasks** (`Function`) `[TRIVIAL]`
     - 📝 Retrieve a list of tasks with pagination and optional status filter.
+    - 🔗 CALLS -> `TaskManager`
+    - 🔗 BINDS_TO -> `TASK_TYPE_PLUGIN_MAP`
   - ƒ **get_task** (`Function`) `[TRIVIAL]`
     - 📝 Retrieve the details of a specific task.
+    - 🔗 CALLS -> `TaskManager`
   - ƒ **get_task_logs** (`Function`) `[CRITICAL]`
     - 📝 Retrieve logs for a specific task with optional filtering.
+    - 🔗 CALLS -> `TaskManager`
+    - 🔗 DEPENDS_ON -> `LogFilter`
   - ƒ **get_task_log_stats** (`Function`) `[TRIVIAL]`
     - 📝 Get statistics about logs for a task (counts by level and source).
+    - 🔗 CALLS -> `TaskManager`
+    - 🔗 DEPENDS_ON -> `LogStats`
   - ƒ **get_task_log_sources** (`Function`) `[TRIVIAL]`
     - 📝 Get unique sources for a task's logs.
+    - 🔗 CALLS -> `TaskManager`
   - ƒ **resolve_task** (`Function`) `[TRIVIAL]`
     - 📝 Resolve a task that is awaiting mapping.
+    - 🔗 CALLS -> `TaskManager`
   - ƒ **resume_task** (`Function`) `[TRIVIAL]`
     - 📝 Resume a task that is awaiting input (e.g., passwords).
+    - 🔗 CALLS -> `TaskManager`
   - ƒ **clear_tasks** (`Function`) `[TRIVIAL]`
     - 📝 Clear tasks matching the status filter.
+    - 🔗 CALLS -> `TaskManager`
 - 📦 **DashboardsApi** (`Module`) `[CRITICAL]`
   - 📝 API endpoints for the Dashboard Hub - listing dashboards with Git and task status
   - 🏗️ Layer: API
@@ -12718,6 +13055,8 @@
   - ƒ **test_get_session_detail_export_and_lifecycle_endpoints** (`Function`) `[TRIVIAL]`
     - 📝 Verify lifecycle get/patch/delete plus documentation and validation exports remain ownership-scoped and usable.
     - 🔗 BINDS_TO -> `DatasetReviewApiTests`
+  - ƒ **test_get_clarification_state_returns_empty_payload_when_session_has_no_record** (`Function`) `[TRIVIAL]`
+    - 📝 Clarification state endpoint should return a non-blocking empty payload when the session has no clarification aggregate yet.
   - ƒ **test_us2_clarification_endpoints_persist_answer_and_feedback** (`Function`) `[TRIVIAL]`
     - 📝 Clarification endpoints should expose one current question, persist the answer before advancement, and store feedback on the answer audit record.
     - 🔗 BINDS_TO -> `DatasetReviewApiTests`
@@ -12727,9 +13066,15 @@
   - ƒ **test_us3_mapping_patch_approval_preview_and_launch_endpoints** (`Function`) `[TRIVIAL]`
     - 📝 US3 execution endpoints should persist manual overrides, preserve explicit approval semantics, return contract-shaped preview truth, and expose audited launch handoff.
     - 🔗 BINDS_TO -> `DatasetReviewApiTests`
+  - ƒ **test_us3_preview_response_propagates_refreshed_session_version_for_launch_follow_up** (`Function`) `[TRIVIAL]`
+    - 📝 Preview response should expose the refreshed session version so the normal preview-then-launch UI flow can satisfy optimistic locking without a forced full reload.
+    - 🔗 BINDS_TO -> `DatasetReviewApiTests`
   - ƒ **test_us3_preview_endpoint_returns_failed_preview_without_false_dashboard_not_found_contract_drift** (`Function`) `[TRIVIAL]`
     - 📝 Preview endpoint should preserve API contract and surface generic upstream preview failures without fabricating dashboard-not-found semantics for non-dashboard 404s.
     - 🔗 BINDS_TO -> `DatasetReviewApiTests`
+  - ƒ **test_mutation_endpoints_surface_session_version_conflict_payload** (`Function`) `[TRIVIAL]`
+    - 📝 Dataset review mutation endpoints should return deterministic 409 conflict semantics when optimistic-lock versions are stale.
+    - 🔗 BINDS_TO -> `DatasetReviewApiTests`
   - ƒ **test_execution_snapshot_includes_recovered_imported_filters_without_template_mapping** (`Function`) `[TRIVIAL]`
     - 📝 Recovered imported filters with values should flow into preview filter context even when no template variable mapping exists.
     - 🔗 BINDS_TO -> `DatasetReviewApiTests`
@@ -12747,6 +13092,18 @@
     - 🔗 BINDS_TO -> `DatasetReviewApiTests`
   - ƒ **_add_side_effect** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **_assert_expected_preview_version** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_assert_expected_launch_version** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_assert_expected_pending_preview_version** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_require_session_version** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_prepare_preview** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **_launch_dataset** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **CleanReleaseV2ApiTests** (`Module`)
   - 📝 API contract tests for redesigned clean release endpoints.
   - 🏗️ Layer: Domain
@@ -12983,12 +13340,30 @@
     - 🔗 BINDS_TO -> `AssistantApiTests`
   - ƒ **_clear_assistant_state** (`Function`) `[TRIVIAL]`
     - 🔗 BINDS_TO -> `AssistantApiTests`
+  - ƒ **_dataset_review_session** (`Function`) `[TRIVIAL]`
+    - 📝 Build minimal owned dataset-review session fixture for assistant scoped routing tests.
+    - 🔗 BINDS_TO -> `AssistantApiTests`
+  - ƒ **_await_none** (`Function`) `[TRIVIAL]`
+    - 📝 Async helper returning None for planner fallback tests.
+    - 🔗 BINDS_TO -> `AssistantApiTests`
   - ƒ **test_unknown_command_returns_needs_clarification** (`Function`) `[TRIVIAL]`
     - 📝 Unknown command should return clarification state and unknown intent.
     - 🔗 BINDS_TO -> `AssistantApiTests`
   - ƒ **test_capabilities_question_returns_successful_help** (`Function`) `[TRIVIAL]`
     - 📝 Capability query should return deterministic help response.
     - 🔗 BINDS_TO -> `AssistantApiTests`
+  - ƒ **test_assistant_message_request_accepts_dataset_review_session_binding** (`Function`) `[TRIVIAL]`
+    - 📝 Assistant request schema should accept active dataset review session binding for scoped orchestration.
+    - 🔗 BINDS_TO -> `AssistantApiTests`
+  - ƒ **test_dataset_review_scoped_message_uses_masked_filter_context** (`Function`) `[TRIVIAL]`
+    - 📝 Session-scoped assistant context should mask imported-filter raw values before assistant-visible metadata is persisted.
+    - 🔗 BINDS_TO -> `AssistantApiTests`
+  - ƒ **test_dataset_review_scoped_command_returns_confirmation_for_mapping_approval** (`Function`) `[TRIVIAL]`
+    - 📝 Session-scoped assistant commands should route dataset-review mapping approvals into confirmation workflow with bound session metadata.
+    - 🔗 BINDS_TO -> `AssistantApiTests`
+  - ƒ **test_dataset_review_scoped_command_routes_field_semantics_update** (`Function`) `[TRIVIAL]`
+    - 📝 Session-scoped assistant commands should route semantic field updates through explicit confirmation metadata.
+    - 🔗 BINDS_TO -> `AssistantApiTests`
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
@@ -13009,6 +13384,10 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **outerjoin** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **options** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **filter** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **order_by** (`Function`) `[TRIVIAL]`
@@ -13037,6 +13416,8 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **refresh** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **_fake_dispatch_dataset_review_intent** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **TestMigrationRoutes** (`Module`)
   - 📝 Unit tests for migration API route handlers.
   - 🏗️ Layer: API
@@ -13521,37 +13902,36 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **test_with_all_fields** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-- ƒ **test_release_candidate_valid** (`Function`) `[TRIVIAL]`
-  - 📝 Verify that a valid release candidate can be instantiated.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- ƒ **test_release_candidate_empty_id** (`Function`) `[TRIVIAL]`
-  - 📝 Verify that a release candidate with an empty ID is rejected.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- ƒ **test_enterprise_policy_valid** (`Function`) `[TRIVIAL]`
-  - 📝 Verify that a valid enterprise policy is accepted.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- ƒ **test_enterprise_policy_missing_prohibited** (`Function`) `[TRIVIAL]`
-  - 📝 Verify that an enterprise policy without prohibited categories is rejected.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- ƒ **test_enterprise_policy_external_allowed** (`Function`) `[TRIVIAL]`
-  - 📝 Verify that an enterprise policy allowing external sources is rejected.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- ƒ **test_manifest_count_mismatch** (`Function`) `[TRIVIAL]`
-  - 📝 Verify that a manifest with count mismatches is rejected.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- ƒ **test_compliant_run_validation** (`Function`) `[TRIVIAL]`
-  - 📝 Verify compliant run validation logic and mandatory stage checks.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- ƒ **test_report_validation** (`Function`) `[TRIVIAL]`
-  - 📝 Verify compliance report validation based on status and violation counts.
-  - 🔗 BINDS_TO -> `__tests__/test_clean_release`
-- 📦 **test_clean_release** (`Module`) `[TRIVIAL]`
-  - 📝 Auto-generated module for backend/src/models/__tests__/test_clean_release.py
-  - 🏗️ Layer: Unknown
+- 📦 **TestCleanReleaseModels** (`Module`) `[TRIVIAL]`
+  - 📝 Contract testing for Clean Release models
   - ƒ **valid_candidate_data** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **valid_policy_data** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- ƒ **test_release_candidate_valid** (`Function`) `[TRIVIAL]`
+  - 📝 Verify that a valid release candidate can be instantiated.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
+- ƒ **test_release_candidate_empty_id** (`Function`) `[TRIVIAL]`
+  - 📝 Verify that a release candidate with an empty ID is rejected.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
+- ƒ **test_enterprise_policy_valid** (`Function`) `[TRIVIAL]`
+  - 📝 Verify that a valid enterprise policy is accepted.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
+- ƒ **test_enterprise_policy_missing_prohibited** (`Function`) `[TRIVIAL]`
+  - 📝 Verify that an enterprise policy without prohibited categories is rejected.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
+- ƒ **test_enterprise_policy_external_allowed** (`Function`) `[TRIVIAL]`
+  - 📝 Verify that an enterprise policy allowing external sources is rejected.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
+- ƒ **test_manifest_count_mismatch** (`Function`) `[TRIVIAL]`
+  - 📝 Verify that a manifest with count mismatches is rejected.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
+- ƒ **test_compliant_run_validation** (`Function`) `[TRIVIAL]`
+  - 📝 Verify compliant run validation logic and mandatory stage checks.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
+- ƒ **test_report_validation** (`Function`) `[TRIVIAL]`
+  - 📝 Verify compliance report validation based on status and violation counts.
+  - 🔗 BINDS_TO -> `TestCleanReleaseModels`
 - 📦 **profile_service** (`Module`) `[CRITICAL]`
   - 📝 Orchestrates profile preference persistence, Superset account lookup, and deterministic actor matching.
   - 🏗️ Layer: Domain
@@ -13731,47 +14111,47 @@
 - 📦 **health_service** (`Module`)
   - 📝 Business logic for aggregating dashboard health status from validation records.
   - 🏗️ Layer: Domain/Service
-  - 🔗 DEPENDS_ON -> `backend.src.models.llm.ValidationRecord`
-  - 🔗 DEPENDS_ON -> `backend.src.core.superset_client.SupersetClient`
-  - 🔗 DEPENDS_ON -> `backend.src.core.task_manager.cleanup.TaskCleanupService`
+  - 🔗 DEPENDS_ON -> `ValidationRecord`
+  - 🔗 DEPENDS_ON -> `SupersetClient`
+  - 🔗 DEPENDS_ON -> `TaskCleanupService`
+  - 🔗 DEPENDS_ON -> `TaskManager`
   - ℂ **HealthService** (`Class`)
     - 📝 Aggregate latest dashboard validation state and manage persisted health report lifecycle.
-    - 🔗 DEPENDS_ON -> `sqlalchemy.orm.Session`
-    - 🔗 DEPENDS_ON -> `backend.src.models.llm.ValidationRecord`
-    - 🔗 DEPENDS_ON -> `backend.src.schemas.health.DashboardHealthItem`
-    - 🔗 DEPENDS_ON -> `backend.src.schemas.health.HealthSummaryResponse`
-    - 🔗 CALLS -> `backend.src.core.superset_client.SupersetClient`
-    - 🔗 CALLS -> `backend.src.core.task_manager.cleanup.TaskCleanupService`
+    - 🔗 DEPENDS_ON -> `ValidationRecord`
+    - 🔗 DEPENDS_ON -> `DashboardHealthItem`
+    - 🔗 DEPENDS_ON -> `HealthSummaryResponse`
+    - 🔗 DEPENDS_ON -> `SupersetClient`
+    - 🔗 DEPENDS_ON -> `TaskCleanupService`
+    - 🔗 DEPENDS_ON -> `TaskManager`
     - ƒ **HealthService_init** (`Function`)
       - 📝 Initialize health service with DB session and optional config access for dashboard metadata resolution.
-      - 🔗 BINDS_TO -> `backend.src.services.health_service.HealthService`
-      - 🔗 DEPENDS_ON -> `sqlalchemy.orm.Session`
+      - 🔗 BINDS_TO -> `HealthService`
     - ƒ **_prime_dashboard_meta_cache** (`Function`)
       - 📝 Warm dashboard slug/title cache with one Superset list fetch per environment.
-      - 🔗 DEPENDS_ON -> `backend.src.models.llm.ValidationRecord`
-      - 🔗 DEPENDS_ON -> `backend.src.core.superset_client.SupersetClient`
-      - 🔗 CALLS -> `config_manager.get_environments`
-      - 🔗 CALLS -> `backend.src.core.superset_client.SupersetClient.get_dashboards_summary`
+      - 🔗 DEPENDS_ON -> `ValidationRecord`
+      - 🔗 DEPENDS_ON -> `ConfigManager`
+      - 🔗 DEPENDS_ON -> `SupersetClient`
     - ƒ **_resolve_dashboard_meta** (`Function`) `[TRIVIAL]`
       - 📝 Resolve slug/title for a dashboard referenced by persisted validation record.
     - ƒ **get_health_summary** (`Function`)
       - 📝 Aggregate latest validation status per dashboard and enrich rows with dashboard slug/title.
-      - 🔗 CALLS -> `self._prime_dashboard_meta_cache`
-      - 🔗 CALLS -> `self._resolve_dashboard_meta`
+      - 🔗 CALLS -> `_prime_dashboard_meta_cache`
+      - 🔗 CALLS -> `_resolve_dashboard_meta`
     - ƒ **delete_validation_report** (`Function`)
       - 📝 Delete one persisted health report and optionally clean linked task/log artifacts.
-      - 🔗 DEPENDS_ON -> `backend.src.models.llm.ValidationRecord`
-      - 🔗 DEPENDS_ON -> `backend.src.core.task_manager.TaskManager`
-      - 🔗 CALLS -> `os.path.exists`
-      - 🔗 CALLS -> `os.remove`
-      - 🔗 CALLS -> `backend.src.core.task_manager.cleanup.TaskCleanupService.delete_task_with_logs`
+      - 🔗 DEPENDS_ON -> `ValidationRecord`
+      - 🔗 DEPENDS_ON -> `TaskManager`
+      - 🔗 DEPENDS_ON -> `TaskCleanupService`
+  - ƒ **_empty_dashboard_meta** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
 - 📦 **llm_provider** (`Module`)
   - 📝 Service for managing LLM provider configurations with encrypted API keys.
   - 🏗️ Layer: Domain
-  - 🔗 DEPENDS_ON -> `backend.src.core.database:Function`
-  - 🔗 DEPENDS_ON -> `backend.src.models.llm:Function`
+  - 🔗 DEPENDS_ON -> `LLMProvider`
+  - 🔗 DEPENDS_ON -> `EncryptionManager`
+  - 🔗 DEPENDS_ON -> `LLMProviderConfig`
   - ƒ **_require_fernet_key** (`Function`) `[CRITICAL]`
     - 📝 Load and validate the Fernet key used for secret encryption.
     - 🔒 Invariant: Encryption initialization never falls back to a hardcoded secret.
@@ -13779,6 +14159,7 @@
   - ℂ **EncryptionManager** (`Class`) `[CRITICAL]`
     - 📝 Handles encryption and decryption of sensitive data like API keys.
     - 🔒 Invariant: Uses only a validated secret key from environment.
+    - 🔗 CALLS -> `_require_fernet_key`
     - ƒ **EncryptionManager_init** (`Function`) `[TRIVIAL]`
       - 📝 Initialize the encryption manager with a Fernet key.
     - ƒ **encrypt** (`Function`) `[TRIVIAL]`
@@ -13787,20 +14168,35 @@
       - 📝 Decrypt an encrypted string.
   - ℂ **LLMProviderService** (`Class`)
     - 📝 Service to manage LLM provider lifecycle.
+    - 🔗 DEPENDS_ON -> `LLMProvider`
+    - 🔗 DEPENDS_ON -> `EncryptionManager`
+    - 🔗 DEPENDS_ON -> `LLMProviderConfig`
     - ƒ **LLMProviderService_init** (`Function`) `[TRIVIAL]`
       - 📝 Initialize the service with database session.
+      - 🔗 DEPENDS_ON -> `EncryptionManager`
     - ƒ **get_all_providers** (`Function`)
       - 📝 Returns all configured LLM providers.
+      - 🔗 DEPENDS_ON -> `LLMProvider`
     - ƒ **get_provider** (`Function`)
       - 📝 Returns a single LLM provider by ID.
+      - 🔗 DEPENDS_ON -> `LLMProvider`
     - ƒ **create_provider** (`Function`)
       - 📝 Creates a new LLM provider with encrypted API key.
+      - 🔗 DEPENDS_ON -> `LLMProviderConfig`
+      - 🔗 DEPENDS_ON -> `LLMProvider`
+      - 🔗 CALLS -> `encrypt`
     - ƒ **update_provider** (`Function`)
       - 📝 Updates an existing LLM provider.
+      - 🔗 DEPENDS_ON -> `LLMProviderConfig`
+      - 🔗 DEPENDS_ON -> `LLMProvider`
+      - 🔗 CALLS -> `encrypt`
     - ƒ **delete_provider** (`Function`)
       - 📝 Deletes an LLM provider.
+      - 🔗 DEPENDS_ON -> `LLMProvider`
     - ƒ **get_decrypted_api_key** (`Function`)
       - 📝 Returns the decrypted API key for a provider.
+      - 🔗 DEPENDS_ON -> `LLMProvider`
+      - 🔗 CALLS -> `decrypt`
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
@@ -13845,14 +14241,26 @@
   - 🔗 DEPENDS_ON -> `Role`
   - ℂ **AuthService** (`Class`)
     - 📝 Provides high-level authentication services.
+    - 🔗 DEPENDS_ON -> `AuthRepository`
+    - 🔗 DEPENDS_ON -> `User`
+    - 🔗 DEPENDS_ON -> `Role`
     - ƒ **AuthService_init** (`Function`) `[TRIVIAL]`
       - 📝 Initializes the authentication service with repository access over an active DB session.
     - ƒ **AuthService.authenticate_user** (`Function`)
       - 📝 Validates credentials and account state for local username/password authentication.
+      - 🔗 DEPENDS_ON -> `AuthRepository`
+      - 🔗 CALLS -> `verify_password`
+      - 🔗 DEPENDS_ON -> `User`
     - ƒ **AuthService.create_session** (`Function`)
       - 📝 Issues an access token payload for an already authenticated user.
+      - 🔗 CALLS -> `create_access_token`
+      - 🔗 DEPENDS_ON -> `User`
+      - 🔗 DEPENDS_ON -> `Role`
     - ƒ **AuthService.provision_adfs_user** (`Function`)
       - 📝 Performs ADFS Just-In-Time provisioning and role synchronization from AD group mappings.
+      - 🔗 DEPENDS_ON -> `AuthRepository`
+      - 🔗 DEPENDS_ON -> `User`
+      - 🔗 DEPENDS_ON -> `Role`
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **authenticate_user** (`Function`) `[TRIVIAL]`
@@ -14326,25 +14734,52 @@
   - 📝 Orchestrates notification routing based on user preferences and policy context.
   - 🏗️ Layer: Domain
   - 🔒 Invariant: Missing profile or provider config must not crash the pipeline.
-  - 🔗 DEPENDS_ON -> `backend.src.services.notifications.providers`
-  - 🔗 DEPENDS_ON -> `backend.src.services.profile_service`
-  - 🔗 DEPENDS_ON -> `backend.src.models.llm`
-  - ℂ **NotificationService** (`Class`) `[TRIVIAL]`
+  - 🔗 DEPENDS_ON -> `NotificationProvider`
+  - 🔗 DEPENDS_ON -> `SMTPProvider`
+  - 🔗 DEPENDS_ON -> `TelegramProvider`
+  - 🔗 DEPENDS_ON -> `SlackProvider`
+  - 🔗 DEPENDS_ON -> `ValidationRecord`
+  - 🔗 DEPENDS_ON -> `ValidationPolicy`
+  - 🔗 DEPENDS_ON -> `UserDashboardPreference`
+  - ℂ **NotificationService** (`Class`)
     - 📝 Routes validation reports to appropriate users and channels.
+    - 🔗 DEPENDS_ON -> `NotificationProvider`
+    - 🔗 DEPENDS_ON -> `ValidationRecord`
+    - 🔗 DEPENDS_ON -> `ValidationPolicy`
+    - 🔗 DEPENDS_ON -> `UserDashboardPreference`
+    - ƒ **NotificationService_init** (`Function`)
+      - 📝 Bind DB and configuration collaborators used for provider initialization and routing.
+      - 🔗 BINDS_TO -> `NotificationService`
+      - 🔗 DEPENDS_ON -> `ValidationPolicy`
+    - ƒ **_initialize_providers** (`Function`)
+      - 📝 Materialize configured notification channel adapters once per service lifetime.
+      - 🔗 DEPENDS_ON -> `SMTPProvider`
+      - 🔗 DEPENDS_ON -> `TelegramProvider`
+      - 🔗 DEPENDS_ON -> `SlackProvider`
+    - ƒ **dispatch_report** (`Function`)
+      - 📝 Route one validation record to resolved owners and configured custom channels.
+      - 🔗 CALLS -> `_initialize_providers`
+      - 🔗 CALLS -> `_should_notify`
+      - 🔗 CALLS -> `_resolve_targets`
+      - 🔗 CALLS -> `_build_body`
+    - ƒ **_should_notify** (`Function`)
+      - 📝 Evaluate record status against effective alert policy.
+      - 🔗 DEPENDS_ON -> `ValidationRecord`
+      - 🔗 DEPENDS_ON -> `ValidationPolicy`
+    - ƒ **_resolve_targets** (`Function`)
+      - 📝 Resolve owner and policy-defined delivery targets for one validation record.
+      - 🔗 CALLS -> `_find_dashboard_owners`
+      - 🔗 DEPENDS_ON -> `ValidationRecord`
+      - 🔗 DEPENDS_ON -> `ValidationPolicy`
+    - ƒ **_find_dashboard_owners** (`Function`)
+      - 📝 Load candidate dashboard owners from persisted profile preferences.
+      - 🔗 DEPENDS_ON -> `ValidationRecord`
+      - 🔗 DEPENDS_ON -> `UserDashboardPreference`
+    - ƒ **_build_body** (`Function`) `[TRIVIAL]`
+      - 📝 Format one validation record into provider-ready body text.
+      - 🔗 DEPENDS_ON -> `ValidationRecord`
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-  - ƒ **_initialize_providers** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **dispatch_report** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **_should_notify** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **_resolve_targets** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **_find_dashboard_owners** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **_build_body** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
 - 📦 **notifications** (`Package`) `[TRIVIAL]`
   - 📝 Notification service package root.
 - 📦 **test_notification_service** (`Module`) `[TRIVIAL]`
@@ -14992,15 +15427,25 @@
   - 📝 Aggregate, normalize, filter, and paginate task reports for unified list/detail API use cases.
   - 🏗️ Layer: Domain
   - 🔒 Invariant: List responses are deterministic and include applied filter echo metadata.
-  - 🔗 DEPENDS_ON -> `backend.src.core.task_manager.manager.TaskManager:Function`
-  - 🔗 DEPENDS_ON -> `backend.src.models.report:Function`
-  - 🔗 DEPENDS_ON -> `backend.src.services.reports.normalizer:Function`
+  - 🔗 DEPENDS_ON -> `TaskManager`
+  - 🔗 DEPENDS_ON -> `TaskReport`
+  - 🔗 DEPENDS_ON -> `ReportQuery`
+  - 🔗 DEPENDS_ON -> `ReportCollection`
+  - 🔗 DEPENDS_ON -> `ReportDetailView`
+  - 🔗 DEPENDS_ON -> `normalize_task_report`
+  - 🔗 DEPENDS_ON -> `CleanReleaseRepository`
   - ℂ **ReportsService** (`Class`) `[CRITICAL]`
     - 📝 Service layer for list/detail report retrieval and normalization.
     - 🔒 Invariant: Service methods are read-only over task history source.
+    - 🔗 DEPENDS_ON -> `TaskManager`
+    - 🔗 DEPENDS_ON -> `CleanReleaseRepository`
+    - 🔗 CALLS -> `normalize_task_report`
     - ƒ **init** (`Function`) `[CRITICAL]`
       - 📝 Initialize service with TaskManager dependency.
       - 🔒 Invariant: Constructor performs no task mutations.
+      - 🔗 BINDS_TO -> `ReportsService`
+      - 🔗 DEPENDS_ON -> `TaskManager`
+      - 🔗 DEPENDS_ON -> `CleanReleaseRepository`
     - ƒ **_load_normalized_reports** (`Function`) `[TRIVIAL]`
       - 📝 Build normalized reports from all available tasks.
       - 🔒 Invariant: Every returned item is a TaskReport.
@@ -15297,6 +15742,8 @@
   - 🔗 DEPENDS_ON -> `DatasetProfile`
   - 🔗 DEPENDS_ON -> `ValidationFinding`
   - 🔗 DEPENDS_ON -> `CompiledPreview`
+  - ℂ **DatasetReviewSessionVersionConflictError** (`Class`) `[TRIVIAL]`
+    - 📝 Signal optimistic-lock conflicts for dataset review session mutations.
   - ℂ **DatasetReviewSessionRepository** (`Class`)
     - 📝 Enforce ownership-scoped persistence and retrieval for dataset review session aggregates.
     - 🔗 DEPENDS_ON -> `DatasetReviewSession`
@@ -15312,6 +15759,12 @@
     - ƒ **create_sess** (`Function`)
       - 📝 Persist an initial dataset review session shell.
       - 🔗 DEPENDS_ON -> `DatasetReviewSession`
+    - ƒ **require_session_version** (`Function`)
+      - 📝 Enforce optimistic-lock version matching before a session mutation is persisted.
+      - 🔗 DEPENDS_ON -> `DatasetReviewSession`
+    - ƒ **bump_session_version** (`Function`)
+      - 📝 Increment optimistic-lock version after a successful session mutation is assembled.
+      - 🔗 DEPENDS_ON -> `DatasetReviewSession`
     - ƒ **load_detail** (`Function`)
       - 📝 Return the full session aggregate for API and frontend resume flows.
       - 🔗 DEPENDS_ON -> `DatasetReviewSession`
@@ -15339,6 +15792,8 @@
       - 🔗 DEPENDS_ON -> `DatasetReviewSession`
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **__init__** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
   - ƒ **_get_owned_session** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **create_session** (`Function`) `[TRIVIAL]`
@@ -15361,6 +15816,15 @@
   - ƒ **test_create_session** (`Function`) `[TRIVIAL]`
     - 📝 Verify session creation and persistence.
     - 🔗 BINDS_TO -> `SessionRepositoryTests`
+  - ƒ **test_require_session_version_conflict** (`Function`) `[TRIVIAL]`
+    - 📝 Verify optimistic-lock conflict is raised when caller version is stale.
+    - 🔗 BINDS_TO -> `SessionRepositoryTests`
+  - ƒ **test_bump_session_version_updates_last_activity** (`Function`) `[TRIVIAL]`
+    - 📝 Verify repository version bump increments monotonically and refreshes last activity.
+    - 🔗 BINDS_TO -> `SessionRepositoryTests`
+  - ƒ **test_save_recovery_state_preserves_raw_value_masked_flag** (`Function`) `[TRIVIAL]`
+    - 📝 Verify imported-filter masking metadata persists with recovery bootstrap state.
+    - 🔗 BINDS_TO -> `SessionRepositoryTests`
   - ƒ **test_load_session_detail_ownership** (`Function`) `[TRIVIAL]`
     - 📝 Verify ownership enforcement in detail loading.
     - 🔗 BINDS_TO -> `SessionRepositoryTests`
@@ -15370,12 +15834,18 @@
   - ƒ **test_save_preview_marks_stale** (`Function`) `[TRIVIAL]`
     - 📝 Verify that saving a new preview marks old ones as stale.
     - 🔗 BINDS_TO -> `SessionRepositoryTests`
+  - ƒ **test_save_preview_increments_session_version_once_per_call** (`Function`) `[TRIVIAL]`
+    - 📝 Verify preview persistence itself contributes exactly one optimistic-lock version increment so higher orchestration layers do not need to bump again for the same preview mutation.
+    - 🔗 BINDS_TO -> `SessionRepositoryTests`
   - ƒ **test_save_profile_and_findings** (`Function`) `[TRIVIAL]`
     - 📝 Verify persistence of profile and findings.
     - 🔗 BINDS_TO -> `SessionRepositoryTests`
   - ƒ **test_save_run_context** (`Function`) `[TRIVIAL]`
     - 📝 Verify saving of run context.
     - 🔗 BINDS_TO -> `SessionRepositoryTests`
+  - ƒ **test_ensure_dataset_review_session_columns_adds_missing_legacy_columns** (`Function`) `[TRIVIAL]`
+    - 📝 Verify additive dataset review migration creates missing legacy columns for session and imported-filter tables without dropping rows.
+    - 🔗 BINDS_TO -> `SessionRepositoryTests`
   - ƒ **test_list_sessions_for_user** (`Function`) `[TRIVIAL]`
     - 📝 Verify listing of sessions by user.
     - 🔗 BINDS_TO -> `SessionRepositoryTests`
@@ -16030,10 +16500,15 @@
 - 📦 **TestResourceHubs** (`Module`)
   - 📝 Contract tests for resource hub dashboards/datasets listing and pagination boundary validation.
   - 🏗️ Layer: Domain (Tests)
-  - 📦 **test_dashboards_api** (`Test`) `[TRIVIAL]`
+  - 🔗 DEPENDS_ON -> `DashboardsApi`
+  - 🔗 DEPENDS_ON -> `DatasetsApi`
+  - ▦ **test_dashboards_api** (`Block`) `[TRIVIAL]`
     - 📝 Verify GET /api/dashboards contract compliance
-    - 🔒 Invariant: unconstrained mock — no spec= enforced; attribute typos will silently pass
     - 🔗 BINDS_TO -> `TestResourceHubs`
+    - ƒ **mock_deps** (`Function`) `[TRIVIAL]`
+      - 📝 Provide dependency override fixture for resource hub route tests.
+      - 🔒 Invariant: unconstrained mock — no spec= enforced; attribute typos will silently pass
+      - 🔗 BINDS_TO -> `TestResourceHubs`
     - ƒ **test_get_dashboards_success** (`Function`) `[TRIVIAL]`
       - 📝 Verify dashboards endpoint returns 200 with expected dashboard payload fields.
       - 🔗 BINDS_TO -> `test_dashboards_api`
@@ -16043,7 +16518,7 @@
     - ƒ **test_get_dashboards_search** (`Function`) `[TRIVIAL]`
       - 📝 Verify dashboards endpoint search filter returns matching subset.
       - 🔗 BINDS_TO -> `test_dashboards_api`
-  - 📦 **test_datasets_api** (`Test`) `[TRIVIAL]`
+  - ▦ **test_datasets_api** (`Block`) `[TRIVIAL]`
     - 📝 Verify GET /api/datasets contract compliance
     - 🔗 BINDS_TO -> `TestResourceHubs`
     - ƒ **test_get_datasets_success** (`Function`) `[TRIVIAL]`
@@ -16058,7 +16533,7 @@
     - ƒ **test_get_datasets_service_failure** (`Function`) `[TRIVIAL]`
       - 📝 Verify datasets endpoint surfaces backend fetch failure as HTTP 503.
       - 🔗 BINDS_TO -> `test_datasets_api`
-  - 📦 **test_pagination_boundaries** (`Test`) `[TRIVIAL]`
+  - ▦ **test_pagination_boundaries** (`Block`) `[TRIVIAL]`
     - 📝 Verify pagination validation for GET endpoints
     - 🔗 BINDS_TO -> `TestResourceHubs`
     - ƒ **test_get_dashboards_pagination_zero_page** (`Function`) `[TRIVIAL]`
@@ -16073,8 +16548,6 @@
     - ƒ **test_get_datasets_pagination_oversize** (`Function`) `[TRIVIAL]`
       - 📝 Verify datasets endpoint rejects oversized page_size with HTTP 400.
       - 🔗 BINDS_TO -> `test_pagination_boundaries`
-  - ƒ **mock_deps** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
 - 📦 **test_smoke_plugins** (`Module`) `[TRIVIAL]`
   - 📝 Auto-generated module for backend/tests/test_smoke_plugins.py
   - 🏗️ Layer: Unknown
@@ -16367,6 +16840,7 @@
 - 📦 **TestDryRunOrchestrator** (`Module`)
   - 📝 Unit tests for MigrationDryRunService diff and risk computation contracts.
   - 🏗️ Layer: Domain
+  - 🔗 DEPENDS_ON -> `MigrationDryRunOrchestratorModule`
   - ƒ **_load_fixture** (`Function`) `[TRIVIAL]`
     - 📝 Load canonical migration dry-run fixture payload used by deterministic orchestration assertions.
     - 🔗 BINDS_TO -> `TestDryRunOrchestrator`
@@ -16379,6 +16853,7 @@
 - 📦 **TestArchiveParser** (`Module`)
   - 📝 Unit tests for MigrationArchiveParser ZIP extraction contract.
   - 🏗️ Layer: Domain
+  - 🔗 DEPENDS_ON -> `MigrationArchiveParserModule`
   - ƒ **test_extract_objects_from_zip_collects_all_types** (`Function`) `[TRIVIAL]`
     - 📝 Verify archive parser collects dashboard/chart/dataset YAML objects into typed buckets.
     - 🔗 BINDS_TO -> `TestArchiveParser`
diff --git a/.kilo/mcp.json b/.kilo/mcp.json
new file mode 100644
index 00000000..a50de7ec
--- /dev/null
+++ b/.kilo/mcp.json
@@ -0,0 +1,52 @@
+{
+  "mcpServers": {
+    "axiom-core": {
+      "command": "/home/busya/dev/ast-mcp-core-server/.venv/bin/python",
+      "args": [
+        "-c",
+        "from src.server import main; main()"
+      ],
+      "env": {
+        "PYTHONPATH": "/home/busya/dev/ast-mcp-core-server"
+      },
+      "alwaysAllow": [
+        "read_grace_outline_tool",
+        "ast_search_tool",
+        "get_semantic_context_tool",
+        "build_task_context_tool",
+        "audit_contracts_tool",
+        "diff_contract_semantics_tool",
+        "simulate_patch_tool",
+        "patch_contract_tool",
+        "rename_contract_id_tool",
+        "move_contract_tool",
+        "extract_contract_tool",
+        "infer_missing_relations_tool",
+        "map_runtime_trace_to_contracts_tool",
+        "scaffold_contract_tests_tool",
+        "search_contracts_tool",
+        "reindex_workspace_tool",
+        "prune_contract_metadata_tool",
+        "workspace_semantic_health_tool",
+        "trace_tests_for_contract_tool",
+        "guarded_patch_contract_tool",
+        "impact_analysis_tool",
+        "update_contract_metadata_tool",
+        "wrap_node_in_contract_tool",
+        "rename_semantic_tag_tool",
+        "scan_vulnerabilities"
+      ]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": [
+        "chrome-devtools-mcp@latest",
+        "--browser-url=http://127.0.0.1:9222"
+      ],
+      "disabled": false,
+      "alwaysAllow": [
+        "take_snapshot"
+      ]
+    }
+  }
+}
diff --git a/.kilocode/workflows/speckit.semantics.md b/.kilocode/workflows/speckit.semantics.md
index ff0d2d68..39e35d6a 100644
--- a/.kilocode/workflows/speckit.semantics.md
+++ b/.kilocode/workflows/speckit.semantics.md
@@ -30,11 +30,11 @@ Ensure the codebase adheres to the semantic standards defined in `.ai/standards/
 
 ### 1. Reindex Semantic Workspace
 
-Use MCP to refresh the semantic graph for the current workspace with [`reindex_workspace_tool`](.kilocode/mcp.json).
+Use MCP to refresh the semantic graph for the current workspace with [`reindex_workspace_tool`](.kilo/mcp.json).
 
 ### 2. Analyze Semantic Health
 
-Use [`workspace_semantic_health_tool`](.kilocode/mcp.json) and capture:
+Use [`workspace_semantic_health_tool`](.kilo/mcp.json) and capture:
 - `contracts`
 - `relations`
 - `orphans`
@@ -45,7 +45,7 @@ Treat high orphan counts and unresolved relations as first-class health indicato
 
 ### 3. Audit Critical Issues
 
-Use [`audit_contracts_tool`](.kilocode/mcp.json) and classify findings into:
+Use [`audit_contracts_tool`](.kilo/mcp.json) and classify findings into:
 - **Critical Parsing/Structure Errors**: malformed or incoherent semantic contract regions
 - **Critical Contract Gaps**: missing [`@DATA_CONTRACT`](.ai/standards/semantics.md), [`@PRE`](.ai/standards/semantics.md), [`@POST`](.ai/standards/semantics.md), [`@SIDE_EFFECT`](.ai/standards/semantics.md) on CRITICAL contracts
 - **Coverage Gaps**: missing [`@TIER`](.ai/standards/semantics.md), missing [`@PURPOSE`](.ai/standards/semantics.md)
@@ -53,7 +53,7 @@ Use [`audit_contracts_tool`](.kilocode/mcp.json) and classify findings into:
 
 ### 4. Build Remediation Context
 
-For the top failing contracts, use MCP semantic context tools such as [`get_semantic_context_tool`](.kilocode/mcp.json), [`build_task_context_tool`](.kilocode/mcp.json), [`impact_analysis_tool`](.kilocode/mcp.json), and [`trace_tests_for_contract_tool`](.kilocode/mcp.json) to understand:
+For the top failing contracts, use MCP semantic context tools such as [`get_semantic_context_tool`](.kilo/mcp.json), [`build_task_context_tool`](.kilo/mcp.json), [`impact_analysis_tool`](.kilo/mcp.json), and [`trace_tests_for_contract_tool`](.kilo/mcp.json) to understand:
 1. Local contract intent
 2. Upstream/downstream semantic impact
 3. Related tests and fixtures
@@ -63,7 +63,7 @@ For the top failing contracts, use MCP semantic context tools such as [`get_sema
 
 If $ARGUMENTS contains `fix` or `apply`:
 - Handoff to the [`semantic`](.kilocodemodes) mode or a dedicated implementation agent instead of applying naive textual edits in orchestration.
-- Require the fixing agent to prefer MCP contract mutation tools such as [`simulate_patch_tool`](.kilocode/mcp.json), [`guarded_patch_contract_tool`](.kilocode/mcp.json), [`patch_contract_tool`](.kilocode/mcp.json), and [`infer_missing_relations_tool`](.kilocode/mcp.json).
+- Require the fixing agent to prefer MCP contract mutation tools such as [`simulate_patch_tool`](.kilo/mcp.json), [`guarded_patch_contract_tool`](.kilo/mcp.json), [`patch_contract_tool`](.kilo/mcp.json), and [`infer_missing_relations_tool`](.kilo/mcp.json).
 - After changes, re-run reindex, health, and audit MCP steps to verify the delta.
 
 ### 6. Review Gate
diff --git a/backend/src/api/routes/__init__.py b/backend/src/api/routes/__init__.py
index b589aca5..6364a93a 100755
--- a/backend/src/api/routes/__init__.py
+++ b/backend/src/api/routes/__init__.py
@@ -4,9 +4,41 @@
 # @PURPOSE: Provide lazy route module loading to avoid heavyweight imports during tests.
 # @LAYER: API
 # @RELATION: [CALLS] ->[ApiRoutesGetAttr]
+# @RELATION: [BINDS_TO] ->[Route_Group_Contracts]
 # @INVARIANT: Only names listed in __all__ are importable via __getattr__.
 
-__all__ = ['plugins', 'tasks', 'settings', 'connections', 'environments', 'mappings', 'migration', 'git', 'storage', 'admin', 'reports', 'assistant', 'clean_release', 'profile', 'dataset_review']
+# [DEF:Route_Group_Contracts:Block]
+# @COMPLEXITY: 3
+# @PURPOSE: Declare the canonical route-module registry used by lazy imports and app router inclusion.
+# @RELATION: DEPENDS_ON -> [PluginsRouter]
+# @RELATION: DEPENDS_ON -> [TasksRouter]
+# @RELATION: DEPENDS_ON -> [SettingsRouter]
+# @RELATION: DEPENDS_ON -> [ConnectionsRouter]
+# @RELATION: DEPENDS_ON -> [ReportsRouter]
+# @RELATION: DEPENDS_ON -> [LlmRoutes]
+__all__ = [
+    "plugins",
+    "tasks",
+    "settings",
+    "connections",
+    "environments",
+    "mappings",
+    "migration",
+    "git",
+    "storage",
+    "admin",
+    "reports",
+    "assistant",
+    "clean_release",
+    "clean_release_v2",
+    "profile",
+    "dataset_review",
+    "llm",
+    "dashboards",
+    "datasets",
+    "health",
+]
+# [/DEF:Route_Group_Contracts:Block]
 
 
 # [DEF:ApiRoutesGetAttr:Function]
@@ -18,7 +50,10 @@ __all__ = ['plugins', 'tasks', 'settings', 'connections', 'environments', 'mappi
 def __getattr__(name):
     if name in __all__:
         import importlib
+
         return importlib.import_module(f".{name}", __name__)
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
 # [/DEF:ApiRoutesGetAttr:Function]
 # [/DEF:ApiRoutesModule:Module]
diff --git a/backend/src/api/routes/__tests__/test_assistant_api.py b/backend/src/api/routes/__tests__/test_assistant_api.py
index 90823a7a..66ee9ced 100644
--- a/backend/src/api/routes/__tests__/test_assistant_api.py
+++ b/backend/src/api/routes/__tests__/test_assistant_api.py
@@ -559,6 +559,4 @@ def test_dataset_review_scoped_command_routes_field_semantics_update():
 # [/DEF:test_dataset_review_scoped_command_routes_field_semantics_update:Function]
 
 
-# [/DEF:test_capabilities_question_returns_successful_help:Function]
-
 # [/DEF:AssistantApiTests:Module]
diff --git a/backend/src/api/routes/clean_release_v2.py b/backend/src/api/routes/clean_release_v2.py
index 8b74fe05..cafb9443 100644
--- a/backend/src/api/routes/clean_release_v2.py
+++ b/backend/src/api/routes/clean_release_v2.py
@@ -1,6 +1,13 @@
 # [DEF:CleanReleaseV2Api:Module]
 # @COMPLEXITY: 4
 # @PURPOSE: Redesigned clean release API for headless candidate lifecycle.
+# @LAYER: UI (API)
+# @RELATION: DEPENDS_ON -> [CleanReleaseRepository]
+# @RELATION: CALLS -> [approve_candidate]
+# @RELATION: CALLS -> [publish_candidate]
+# @PRE: Clean release repository dependency is available for candidate lifecycle endpoints.
+# @POST: Candidate registration, approval, publication, and revocation routes are registered without behavior changes.
+# @SIDE_EFFECT: Persists candidate lifecycle state through clean release services and repository adapters.
 
 from fastapi import APIRouter, Depends, HTTPException, status
 from typing import List, Dict, Any
@@ -29,7 +36,6 @@ router = APIRouter(prefix="/api/v2/clean-release", tags=["Clean Release V2"])
 # [DEF:ApprovalRequest:Class]
 # @COMPLEXITY: 1
 # @PURPOSE: Schema for approval request payload.
-# @RELATION: USES -> [CandidateDTO]
 class ApprovalRequest(dict):
     pass
 
@@ -40,7 +46,6 @@ class ApprovalRequest(dict):
 # [DEF:PublishRequest:Class]
 # @COMPLEXITY: 1
 # @PURPOSE: Schema for publication request payload.
-# @RELATION: USES -> [CandidateDTO]
 class PublishRequest(dict):
     pass
 
@@ -51,7 +56,6 @@ class PublishRequest(dict):
 # [DEF:RevokeRequest:Class]
 # @COMPLEXITY: 1
 # @PURPOSE: Schema for revocation request payload.
-# @RELATION: USES -> [CandidateDTO]
 class RevokeRequest(dict):
     pass
 
@@ -66,7 +70,7 @@ class RevokeRequest(dict):
 # @POST: Candidate is saved in repository.
 # @RETURN: CandidateDTO
 # @RELATION: CALLS -> [CleanReleaseRepository.save_candidate]
-# @RELATION: USES -> [CandidateDTO]
+# @RELATION: DEPENDS_ON -> [CandidateDTO]
 @router.post(
     "/candidates", response_model=CandidateDTO, status_code=status.HTTP_201_CREATED
 )
diff --git a/backend/src/api/routes/llm.py b/backend/src/api/routes/llm.py
index dc070b0a..76ed505a 100644
--- a/backend/src/api/routes/llm.py
+++ b/backend/src/api/routes/llm.py
@@ -1,8 +1,12 @@
-# [DEF:backend/src/api/routes/llm.py:Module]
-# @COMPLEXITY: 2
+# [DEF:LlmRoutes:Module]
+# @COMPLEXITY: 3
 # @SEMANTICS: api, routes, llm
 # @PURPOSE: API routes for LLM provider configuration and management.
 # @LAYER: UI (API)
+# @RELATION: DEPENDS_ON -> [LLMProviderService]
+# @RELATION: DEPENDS_ON -> [LLMProviderConfig]
+# @RELATION: DEPENDS_ON -> [get_current_user]
+# @RELATION: DEPENDS_ON -> [get_db]
 
 from fastapi import APIRouter, Depends, HTTPException, status
 from typing import List, Optional
@@ -24,6 +28,7 @@ router = APIRouter(tags=["LLM"])
 # @PURPOSE: Validate decrypted runtime API key presence/shape.
 # @PRE: value can be None.
 # @POST: Returns True only for non-placeholder key.
+# @RELATION: BINDS_TO -> [LlmRoutes]
 def _is_valid_runtime_api_key(value: Optional[str]) -> bool:
     key = (value or "").strip()
     if not key:
@@ -40,6 +45,8 @@ def _is_valid_runtime_api_key(value: Optional[str]) -> bool:
 # @PURPOSE: Retrieve all LLM provider configurations.
 # @PRE: User is authenticated.
 # @POST: Returns list of LLMProviderConfig.
+# @RELATION: CALLS -> [LLMProviderService]
+# @RELATION: DEPENDS_ON -> [LLMProviderConfig]
 @router.get("/providers", response_model=List[LLMProviderConfig])
 async def get_providers(
     current_user: User = Depends(get_current_active_user), db: Session = Depends(get_db)
@@ -73,6 +80,8 @@ async def get_providers(
 # @PURPOSE: Returns whether LLM runtime is configured for dashboard validation.
 # @PRE: User is authenticated.
 # @POST: configured=true only when an active provider with valid decrypted key exists.
+# @RELATION: CALLS -> [LLMProviderService]
+# @RELATION: CALLS -> [_is_valid_runtime_api_key]
 @router.get("/status")
 async def get_llm_status(
     current_user: User = Depends(get_current_active_user), db: Session = Depends(get_db)
@@ -112,7 +121,9 @@ async def get_llm_status(
             "configured": False,
             "reason": "invalid_api_key",
             "provider_count": len(providers),
-            "active_provider_count": len([provider for provider in providers if provider.is_active]),
+            "active_provider_count": len(
+                [provider for provider in providers if provider.is_active]
+            ),
             "provider_id": active_provider.id,
             "provider_name": active_provider.name,
             "provider_type": active_provider.provider_type,
@@ -123,7 +134,9 @@ async def get_llm_status(
         "configured": True,
         "reason": "ok",
         "provider_count": len(providers),
-        "active_provider_count": len([provider for provider in providers if provider.is_active]),
+        "active_provider_count": len(
+            [provider for provider in providers if provider.is_active]
+        ),
         "provider_id": active_provider.id,
         "provider_name": active_provider.name,
         "provider_type": active_provider.provider_type,
@@ -138,6 +151,8 @@ async def get_llm_status(
 # @PURPOSE: Create a new LLM provider configuration.
 # @PRE: User is authenticated and has admin permissions.
 # @POST: Returns the created LLMProviderConfig.
+# @RELATION: CALLS -> [LLMProviderService]
+# @RELATION: DEPENDS_ON -> [LLMProviderConfig]
 @router.post(
     "/providers", response_model=LLMProviderConfig, status_code=status.HTTP_201_CREATED
 )
@@ -169,6 +184,8 @@ async def create_provider(
 # @PURPOSE: Update an existing LLM provider configuration.
 # @PRE: User is authenticated and has admin permissions.
 # @POST: Returns the updated LLMProviderConfig.
+# @RELATION: CALLS -> [LLMProviderService]
+# @RELATION: DEPENDS_ON -> [LLMProviderConfig]
 @router.put("/providers/{provider_id}", response_model=LLMProviderConfig)
 async def update_provider(
     provider_id: str,
@@ -202,6 +219,7 @@ async def update_provider(
 # @PURPOSE: Delete an LLM provider configuration.
 # @PRE: User is authenticated and has admin permissions.
 # @POST: Returns success status.
+# @RELATION: CALLS -> [LLMProviderService]
 @router.delete("/providers/{provider_id}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_provider(
     provider_id: str,
@@ -224,6 +242,8 @@ async def delete_provider(
 # @PURPOSE: Test connection to an LLM provider.
 # @PRE: User is authenticated.
 # @POST: Returns success status and message.
+# @RELATION: CALLS -> [LLMProviderService]
+# @RELATION: DEPENDS_ON -> [LLMClient]
 @router.post("/providers/{provider_id}/test")
 async def test_connection(
     provider_id: str,
@@ -276,6 +296,8 @@ async def test_connection(
 # @PURPOSE: Test connection with a provided configuration (not yet saved).
 # @PRE: User is authenticated.
 # @POST: Returns success status and message.
+# @RELATION: DEPENDS_ON -> [LLMClient]
+# @RELATION: DEPENDS_ON -> [LLMProviderConfig]
 @router.post("/providers/test")
 async def test_provider_config(
     config: LLMProviderConfig, current_user: User = Depends(get_current_active_user)
@@ -311,4 +333,4 @@ async def test_provider_config(
 
 # [/DEF:test_provider_config:Function]
 
-# [/DEF:backend/src/api/routes/llm.py:Module]
+# [/DEF:LlmRoutes:Module]
diff --git a/backend/src/api/routes/plugins.py b/backend/src/api/routes/plugins.py
index 45639c45..f5b830ed 100755
--- a/backend/src/api/routes/plugins.py
+++ b/backend/src/api/routes/plugins.py
@@ -3,7 +3,9 @@
 # @SEMANTICS: api, router, plugins, list
 # @PURPOSE: Defines the FastAPI router for plugin-related endpoints, allowing clients to list available plugins.
 # @LAYER: UI (API)
-# @RELATION: Depends on the PluginLoader and PluginConfig. It is included by the main app.
+# @RELATION: DEPENDS_ON -> [PluginConfig]
+# @RELATION: DEPENDS_ON -> [get_plugin_loader]
+# @RELATION: BINDS_TO -> [API_Routes]
 from typing import List
 from fastapi import APIRouter, Depends
 
@@ -13,20 +15,25 @@ from ...core.logger import belief_scope
 
 router = APIRouter()
 
+
 # [DEF:list_plugins:Function]
 # @PURPOSE: Retrieve a list of all available plugins.
 # @PRE: plugin_loader is injected via Depends.
 # @POST: Returns a list of PluginConfig objects.
 # @RETURN: List[PluginConfig] - List of registered plugins.
+# @RELATION: CALLS -> [get_plugin_loader]
+# @RELATION: DEPENDS_ON -> [PluginConfig]
 @router.get("", response_model=List[PluginConfig])
 async def list_plugins(
-    plugin_loader = Depends(get_plugin_loader),
-    _ = Depends(has_permission("plugins", "READ"))
+    plugin_loader=Depends(get_plugin_loader),
+    _=Depends(has_permission("plugins", "READ")),
 ):
     with belief_scope("list_plugins"):
         """
         Retrieve a list of all available plugins.
         """
         return plugin_loader.get_all_plugin_configs()
+
+
 # [/DEF:list_plugins:Function]
-# [/DEF:PluginsRouter:Module]
\ No newline at end of file
+# [/DEF:PluginsRouter:Module]
diff --git a/backend/src/api/routes/reports.py b/backend/src/api/routes/reports.py
index 05a79323..86b57905 100644
--- a/backend/src/api/routes/reports.py
+++ b/backend/src/api/routes/reports.py
@@ -49,6 +49,7 @@ router = APIRouter(prefix="/api/reports", tags=["Reports"])
 # @PARAM: enum_cls (type) - Enum class for validation.
 # @PARAM: field_name (str) - Query field name for diagnostics.
 # @RETURN: List - Parsed enum values.
+# @RELATION: BINDS_TO -> [ReportsRouter]
 def _parse_csv_enum_list(raw: Optional[str], enum_cls, field_name: str) -> List:
     with belief_scope("_parse_csv_enum_list"):
         if raw is None or not raw.strip():
@@ -158,6 +159,7 @@ async def list_reports(
 # @PURPOSE: Return one normalized report detail with diagnostics and next actions.
 # @PRE: authenticated/authorized request and existing report_id.
 # @POST: returns normalized detail envelope or 404 when report is not found.
+# @RELATION: CALLS -> [ReportsService:Class]
 @router.get("/{report_id}", response_model=ReportDetailView)
 async def get_report_detail(
     report_id: str,
diff --git a/backend/src/api/routes/tasks.py b/backend/src/api/routes/tasks.py
index be9df800..46e460ee 100755
--- a/backend/src/api/routes/tasks.py
+++ b/backend/src/api/routes/tasks.py
@@ -15,7 +15,12 @@ from ...core.logger import belief_scope
 
 from ...core.task_manager import TaskManager, Task, TaskStatus, LogEntry
 from ...core.task_manager.models import LogFilter, LogStats
-from ...dependencies import get_task_manager, has_permission, get_current_user, get_config_manager
+from ...dependencies import (
+    get_task_manager,
+    has_permission,
+    get_current_user,
+    get_config_manager,
+)
 from ...core.config_manager import ConfigManager
 from ...services.llm_prompt_templates import (
     is_multimodal_model,
@@ -32,16 +37,20 @@ TASK_TYPE_PLUGIN_MAP = {
     "migration": ["superset-migration"],
 }
 
+
 class CreateTaskRequest(BaseModel):
     plugin_id: str
     params: Dict[str, Any]
 
+
 class ResolveTaskRequest(BaseModel):
     resolution_params: Dict[str, Any]
 
+
 class ResumeTaskRequest(BaseModel):
     passwords: Dict[str, str]
 
+
 # [DEF:create_task:Function]
 # @COMPLEXITY: 3
 # @PURPOSE: Create and start a new task for a given plugin.
@@ -50,11 +59,14 @@ class ResumeTaskRequest(BaseModel):
 # @PRE: plugin_id must exist and params must be valid for that plugin.
 # @POST: A new task is created and started.
 # @RETURN: Task - The created task instance.
+# @RELATION: CALLS -> [TaskManager]
+# @RELATION: DEPENDS_ON -> [ConfigManager]
+# @RELATION: DEPENDS_ON -> [LLMProviderService]
 @router.post("", response_model=Task, status_code=status.HTTP_201_CREATED)
 async def create_task(
     request: CreateTaskRequest,
     task_manager: TaskManager = Depends(get_task_manager),
-    current_user = Depends(get_current_user),
+    current_user=Depends(get_current_user),
     config_manager: ConfigManager = Depends(get_config_manager),
 ):
     # Dynamic permission check based on plugin_id
@@ -65,19 +77,30 @@ async def create_task(
             if request.plugin_id in {"llm_dashboard_validation", "llm_documentation"}:
                 from ...core.database import SessionLocal
                 from ...services.llm_provider import LLMProviderService
+
                 db = SessionLocal()
                 try:
                     llm_service = LLMProviderService(db)
                     provider_id = request.params.get("provider_id")
                     if not provider_id:
-                        llm_settings = normalize_llm_settings(config_manager.get_config().settings.llm)
-                        binding_key = "dashboard_validation" if request.plugin_id == "llm_dashboard_validation" else "documentation"
-                        provider_id = resolve_bound_provider_id(llm_settings, binding_key)
+                        llm_settings = normalize_llm_settings(
+                            config_manager.get_config().settings.llm
+                        )
+                        binding_key = (
+                            "dashboard_validation"
+                            if request.plugin_id == "llm_dashboard_validation"
+                            else "documentation"
+                        )
+                        provider_id = resolve_bound_provider_id(
+                            llm_settings, binding_key
+                        )
                         if provider_id:
                             request.params["provider_id"] = provider_id
                     if not provider_id:
                         providers = llm_service.get_all_providers()
-                        active_provider = next((p for p in providers if p.is_active), None)
+                        active_provider = next(
+                            (p for p in providers if p.is_active), None
+                        )
                         if active_provider:
                             provider_id = active_provider.id
                             request.params["provider_id"] = provider_id
@@ -86,9 +109,12 @@ async def create_task(
                         db_provider = llm_service.get_provider(provider_id)
                         if not db_provider:
                             raise ValueError(f"LLM Provider {provider_id} not found")
-                        if request.plugin_id == "llm_dashboard_validation" and not is_multimodal_model(
-                            db_provider.default_model,
-                            db_provider.provider_type,
+                        if (
+                            request.plugin_id == "llm_dashboard_validation"
+                            and not is_multimodal_model(
+                                db_provider.default_model,
+                                db_provider.provider_type,
+                            )
                         ):
                             raise HTTPException(
                                 status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
@@ -98,14 +124,16 @@ async def create_task(
                     db.close()
 
             task = await task_manager.create_task(
-                plugin_id=request.plugin_id,
-                params=request.params
+                plugin_id=request.plugin_id, params=request.params
             )
             return task
         except ValueError as e:
             raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=str(e))
+
+
 # [/DEF:create_task:Function]
 
+
 # [DEF:list_tasks:Function]
 # @COMPLEXITY: 2
 # @PURPOSE: Retrieve a list of tasks with pagination and optional status filter.
@@ -116,16 +144,24 @@ async def create_task(
 # @PRE: task_manager must be available.
 # @POST: Returns a list of tasks.
 # @RETURN: List[Task] - List of tasks.
+# @RELATION: CALLS -> [TaskManager]
+# @RELATION: BINDS_TO -> [TASK_TYPE_PLUGIN_MAP]
 @router.get("", response_model=List[Task])
 async def list_tasks(
     limit: int = 10,
     offset: int = 0,
     status_filter: Optional[TaskStatus] = Query(None, alias="status"),
-    task_type: Optional[str] = Query(None, description="Task category: llm_validation, backup, migration"),
-    plugin_id: Optional[List[str]] = Query(None, description="Filter by plugin_id (repeatable query param)"),
-    completed_only: bool = Query(False, description="Return only completed tasks (SUCCESS/FAILED)"),
+    task_type: Optional[str] = Query(
+        None, description="Task category: llm_validation, backup, migration"
+    ),
+    plugin_id: Optional[List[str]] = Query(
+        None, description="Filter by plugin_id (repeatable query param)"
+    ),
+    completed_only: bool = Query(
+        False, description="Return only completed tasks (SUCCESS/FAILED)"
+    ),
     task_manager: TaskManager = Depends(get_task_manager),
-    _ = Depends(has_permission("tasks", "READ"))
+    _=Depends(has_permission("tasks", "READ")),
 ):
     with belief_scope("list_tasks"):
         plugin_filters = list(plugin_id) if plugin_id else []
@@ -133,7 +169,7 @@ async def list_tasks(
             if task_type not in TASK_TYPE_PLUGIN_MAP:
                 raise HTTPException(
                     status_code=status.HTTP_400_BAD_REQUEST,
-                    detail=f"Unsupported task_type '{task_type}'. Allowed: {', '.join(TASK_TYPE_PLUGIN_MAP.keys())}"
+                    detail=f"Unsupported task_type '{task_type}'. Allowed: {', '.join(TASK_TYPE_PLUGIN_MAP.keys())}",
                 )
             plugin_filters.extend(TASK_TYPE_PLUGIN_MAP[task_type])
 
@@ -142,10 +178,13 @@ async def list_tasks(
             offset=offset,
             status=status_filter,
             plugin_ids=plugin_filters or None,
-            completed_only=completed_only
+            completed_only=completed_only,
         )
+
+
 # [/DEF:list_tasks:Function]
 
+
 # [DEF:get_task:Function]
 # @COMPLEXITY: 2
 # @PURPOSE: Retrieve the details of a specific task.
@@ -154,19 +193,25 @@ async def list_tasks(
 # @PRE: task_id must exist.
 # @POST: Returns task details or raises 404.
 # @RETURN: Task - The task details.
+# @RELATION: CALLS -> [TaskManager]
 @router.get("/{task_id}", response_model=Task)
 async def get_task(
     task_id: str,
     task_manager: TaskManager = Depends(get_task_manager),
-    _ = Depends(has_permission("tasks", "READ"))
+    _=Depends(has_permission("tasks", "READ")),
 ):
     with belief_scope("get_task"):
         task = task_manager.get_task(task_id)
         if not task:
-            raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Task not found")
+            raise HTTPException(
+                status_code=status.HTTP_404_NOT_FOUND, detail="Task not found"
+            )
         return task
+
+
 # [/DEF:get_task:Function]
 
+
 # [DEF:get_task_logs:Function]
 # @COMPLEXITY: 5
 # @PURPOSE: Retrieve logs for a specific task with optional filtering.
@@ -180,6 +225,8 @@ async def get_task(
 # @PRE: task_id must exist.
 # @POST: Returns a list of log entries or raises 404.
 # @RETURN: List[LogEntry] - List of log entries.
+# @RELATION: CALLS -> [TaskManager]
+# @RELATION: DEPENDS_ON -> [LogFilter]
 # @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
@@ -190,28 +237,37 @@ async def get_task(
 @router.get("/{task_id}/logs")
 async def get_task_logs(
     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)"
+    ),
     source: Optional[str] = Query(None, description="Filter by source component"),
     search: Optional[str] = Query(None, description="Text search in message"),
     offset: int = Query(0, ge=0, description="Number of logs to skip"),
-    limit: int = Query(100, ge=1, le=1000, description="Maximum number of logs to return"),
+    limit: int = Query(
+        100, ge=1, le=1000, description="Maximum number of logs to return"
+    ),
     task_manager: TaskManager = Depends(get_task_manager),
 ):
     with belief_scope("get_task_logs"):
         task = task_manager.get_task(task_id)
         if not task:
-            raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Task not found")
-        
+            raise HTTPException(
+                status_code=status.HTTP_404_NOT_FOUND, detail="Task not found"
+            )
+
         log_filter = LogFilter(
             level=level.upper() if level else None,
             source=source,
             search=search,
             offset=offset,
-            limit=limit
+            limit=limit,
         )
         return task_manager.get_task_logs(task_id, log_filter)
+
+
 # [/DEF:get_task_logs:Function]
 
+
 # [DEF:get_task_log_stats:Function]
 # @COMPLEXITY: 2
 # @PURPOSE: Get statistics about logs for a task (counts by level and source).
@@ -220,6 +276,8 @@ async def get_task_logs(
 # @PRE: task_id must exist.
 # @POST: Returns log statistics or raises 404.
 # @RETURN: LogStats - Statistics about task logs.
+# @RELATION: CALLS -> [TaskManager]
+# @RELATION: DEPENDS_ON -> [LogStats]
 @router.get("/{task_id}/logs/stats", response_model=LogStats)
 async def get_task_log_stats(
     task_id: str,
@@ -228,26 +286,37 @@ async def get_task_log_stats(
     with belief_scope("get_task_log_stats"):
         task = task_manager.get_task(task_id)
         if not task:
-            raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Task not found")
+            raise HTTPException(
+                status_code=status.HTTP_404_NOT_FOUND, detail="Task not found"
+            )
         stats_payload = task_manager.get_task_log_stats(task_id)
         if isinstance(stats_payload, LogStats):
             return stats_payload
         if isinstance(stats_payload, dict) and (
-            "total_count" in stats_payload or "by_level" in stats_payload or "by_source" in stats_payload
+            "total_count" in stats_payload
+            or "by_level" in stats_payload
+            or "by_source" in stats_payload
         ):
             return LogStats(
                 total_count=int(stats_payload.get("total_count", 0) or 0),
                 by_level=dict(stats_payload.get("by_level") or {}),
                 by_source=dict(stats_payload.get("by_source") or {}),
             )
-        flat_by_level = dict(stats_payload or {}) if isinstance(stats_payload, dict) else {}
+        flat_by_level = (
+            dict(stats_payload or {}) if isinstance(stats_payload, dict) else {}
+        )
         return LogStats(
             total_count=sum(int(value or 0) for value in flat_by_level.values()),
-            by_level={str(key): int(value or 0) for key, value in flat_by_level.items()},
+            by_level={
+                str(key): int(value or 0) for key, value in flat_by_level.items()
+            },
             by_source={},
         )
+
+
 # [/DEF:get_task_log_stats:Function]
 
+
 # [DEF:get_task_log_sources:Function]
 # @COMPLEXITY: 2
 # @PURPOSE: Get unique sources for a task's logs.
@@ -256,6 +325,7 @@ async def get_task_log_stats(
 # @PRE: task_id must exist.
 # @POST: Returns list of unique source names or raises 404.
 # @RETURN: List[str] - Unique source names.
+# @RELATION: CALLS -> [TaskManager]
 @router.get("/{task_id}/logs/sources", response_model=List[str])
 async def get_task_log_sources(
     task_id: str,
@@ -264,10 +334,15 @@ async def get_task_log_sources(
     with belief_scope("get_task_log_sources"):
         task = task_manager.get_task(task_id)
         if not task:
-            raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Task not found")
+            raise HTTPException(
+                status_code=status.HTTP_404_NOT_FOUND, detail="Task not found"
+            )
         return task_manager.get_task_log_sources(task_id)
+
+
 # [/DEF:get_task_log_sources:Function]
 
+
 # [DEF:resolve_task:Function]
 # @COMPLEXITY: 2
 # @PURPOSE: Resolve a task that is awaiting mapping.
@@ -277,12 +352,13 @@ async def get_task_log_sources(
 # @PRE: task must be in AWAITING_MAPPING status.
 # @POST: Task is resolved and resumes execution.
 # @RETURN: Task - The updated task object.
+# @RELATION: CALLS -> [TaskManager]
 @router.post("/{task_id}/resolve", response_model=Task)
 async def resolve_task(
     task_id: str,
     request: ResolveTaskRequest,
     task_manager: TaskManager = Depends(get_task_manager),
-    _ = Depends(has_permission("tasks", "WRITE"))
+    _=Depends(has_permission("tasks", "WRITE")),
 ):
     with belief_scope("resolve_task"):
         try:
@@ -290,8 +366,11 @@ async def resolve_task(
             return task_manager.get_task(task_id)
         except ValueError as e:
             raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
+
+
 # [/DEF:resolve_task:Function]
 
+
 # [DEF:resume_task:Function]
 # @COMPLEXITY: 2
 # @PURPOSE: Resume a task that is awaiting input (e.g., passwords).
@@ -301,12 +380,13 @@ async def resolve_task(
 # @PRE: task must be in AWAITING_INPUT status.
 # @POST: Task resumes execution with provided input.
 # @RETURN: Task - The updated task object.
+# @RELATION: CALLS -> [TaskManager]
 @router.post("/{task_id}/resume", response_model=Task)
 async def resume_task(
     task_id: str,
     request: ResumeTaskRequest,
     task_manager: TaskManager = Depends(get_task_manager),
-    _ = Depends(has_permission("tasks", "WRITE"))
+    _=Depends(has_permission("tasks", "WRITE")),
 ):
     with belief_scope("resume_task"):
         try:
@@ -314,8 +394,11 @@ async def resume_task(
             return task_manager.get_task(task_id)
         except ValueError as e:
             raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
+
+
 # [/DEF:resume_task:Function]
 
+
 # [DEF:clear_tasks:Function]
 # @COMPLEXITY: 2
 # @PURPOSE: Clear tasks matching the status filter.
@@ -323,15 +406,18 @@ async def resume_task(
 # @PARAM: task_manager (TaskManager) - The task manager instance.
 # @PRE: task_manager is available.
 # @POST: Tasks are removed from memory/persistence.
+# @RELATION: CALLS -> [TaskManager]
 @router.delete("", status_code=status.HTTP_204_NO_CONTENT)
 async def clear_tasks(
     status: Optional[TaskStatus] = None,
     task_manager: TaskManager = Depends(get_task_manager),
-    _ = Depends(has_permission("tasks", "WRITE"))
+    _=Depends(has_permission("tasks", "WRITE")),
 ):
     with belief_scope("clear_tasks", f"status={status}"):
         task_manager.clear_tasks(status)
         return
+
+
 # [/DEF:clear_tasks:Function]
 
 # [/DEF:TasksRouter:Module]
diff --git a/backend/src/app.py b/backend/src/app.py
index 0dd2b2ed..41cd331d 100755
--- a/backend/src/app.py
+++ b/backend/src/app.py
@@ -32,19 +32,43 @@ from .core.logger import logger, belief_scope
 from .core.database import AuthSessionLocal
 from .core.auth.security import get_password_hash
 from .models.auth import User, Role
-from .api.routes import plugins, tasks, settings, environments, mappings, migration, connections, git, storage, admin, llm, dashboards, datasets, reports, assistant, clean_release, clean_release_v2, profile, health, dataset_review
+from .api.routes import (
+    plugins,
+    tasks,
+    settings,
+    environments,
+    mappings,
+    migration,
+    connections,
+    git,
+    storage,
+    admin,
+    llm,
+    dashboards,
+    datasets,
+    reports,
+    assistant,
+    clean_release,
+    clean_release_v2,
+    profile,
+    health,
+    dataset_review,
+)
 from .api import auth
 
-# [DEF:App:Global]
-# @COMPLEXITY: 1
-# @SEMANTICS: app, fastapi, instance
-# @PURPOSE: The global FastAPI application instance.
+# [DEF:FastAPI_App:Global]
+# @COMPLEXITY: 3
+# @SEMANTICS: app, fastapi, instance, route-registry
+# @PURPOSE: Canonical FastAPI application instance for route, middleware, and websocket registration.
+# @RELATION: DEPENDS_ON -> [ApiRoutesModule]
+# @RELATION: BINDS_TO -> [API_Routes]
 app = FastAPI(
     title="Superset Tools API",
     description="API for managing Superset automation tools and plugins.",
     version="1.0.0",
 )
-# [/DEF:App:Global]
+# [/DEF:FastAPI_App:Global]
+
 
 # [DEF:ensure_initial_admin_user:Function]
 # @COMPLEXITY: 3
@@ -72,7 +96,9 @@ def ensure_initial_admin_user() -> None:
 
         existing_user = db.query(User).filter(User.username == username).first()
         if existing_user:
-            logger.info("Initial admin bootstrap skipped: user '%s' already exists.", username)
+            logger.info(
+                "Initial admin bootstrap skipped: user '%s' already exists.", username
+            )
             return
 
         new_user = User(
@@ -85,15 +111,20 @@ def ensure_initial_admin_user() -> None:
         new_user.roles.append(admin_role)
         db.add(new_user)
         db.commit()
-        logger.info("Initial admin user '%s' created from environment bootstrap.", username)
+        logger.info(
+            "Initial admin user '%s' created from environment bootstrap.", username
+        )
     except Exception as exc:
         db.rollback()
         logger.error("Failed to bootstrap initial admin user: %s", exc)
         raise
     finally:
         db.close()
+
+
 # [/DEF:ensure_initial_admin_user:Function]
 
+
 # [DEF:startup_event:Function]
 # @COMPLEXITY: 3
 # @PURPOSE: Handles application startup tasks, such as starting the scheduler.
@@ -108,8 +139,11 @@ async def startup_event():
         ensure_initial_admin_user()
         scheduler = get_scheduler_service()
     scheduler.start()
+
+
 # [/DEF:startup_event:Function]
 
+
 # [DEF:shutdown_event:Function]
 # @COMPLEXITY: 3
 # @PURPOSE: Handles application shutdown tasks, such as stopping the scheduler.
@@ -122,12 +156,15 @@ async def shutdown_event():
     with belief_scope("shutdown_event"):
         scheduler = get_scheduler_service()
         scheduler.stop()
+
+
 # [/DEF:shutdown_event:Function]
 
 # [DEF:app_middleware:Block]
 # @PURPOSE: Configure application-wide middleware (Session, CORS).
 # Configure Session Middleware (required by Authlib for OAuth2 flow)
 from .core.auth.config import auth_config
+
 app.add_middleware(SessionMiddleware, secret_key=auth_config.SECRET_KEY)
 
 # Configure CORS
@@ -154,10 +191,13 @@ async def network_error_handler(request: Request, exc: NetworkError):
         logger.error(f"Network error: {exc}")
         return HTTPException(
             status_code=503,
-            detail="Environment unavailable. Please check if the Superset instance is running."
+            detail="Environment unavailable. Please check if the Superset instance is running.",
         )
+
+
 # [/DEF:network_error_handler:Function]
 
+
 # [DEF:log_requests:Function]
 # @COMPLEXITY: 3
 # @PURPOSE: Middleware to log incoming HTTP requests and their response status.
@@ -171,32 +211,50 @@ async def log_requests(request: Request, call_next):
     with belief_scope("log_requests"):
         # Avoid spamming logs for polling endpoints
         is_polling = request.url.path.endswith("/api/tasks") and request.method == "GET"
-        
+
         if not is_polling:
             logger.info(f"Incoming request: {request.method} {request.url.path}")
-        
+
         try:
             response = await call_next(request)
             if not is_polling:
-                logger.info(f"Response status: {response.status_code} for {request.url.path}")
+                logger.info(
+                    f"Response status: {response.status_code} for {request.url.path}"
+                )
             return response
         except NetworkError as e:
             logger.error(f"Network error caught in middleware: {e}")
             raise HTTPException(
                 status_code=503,
-                detail="Environment unavailable. Please check if the Superset instance is running."
+                detail="Environment unavailable. Please check if the Superset instance is running.",
             )
+
+
 # [/DEF:log_requests:Function]
 
-# [DEF:api_routes:Block]
-# @PURPOSE: Register all application API routers.
+# [DEF:API_Routes:Block]
+# @COMPLEXITY: 3
+# @PURPOSE: Register all FastAPI route groups exposed by the application entrypoint.
+# @RELATION: DEPENDS_ON -> [FastAPI_App]
+# @RELATION: DEPENDS_ON -> [Route_Group_Contracts]
+# @RELATION: DEPENDS_ON -> [AuthApi]
+# @RELATION: DEPENDS_ON -> [AdminApi]
+# @RELATION: DEPENDS_ON -> [PluginsRouter]
+# @RELATION: DEPENDS_ON -> [TasksRouter]
+# @RELATION: DEPENDS_ON -> [SettingsRouter]
+# @RELATION: DEPENDS_ON -> [ConnectionsRouter]
+# @RELATION: DEPENDS_ON -> [ReportsRouter]
+# @RELATION: DEPENDS_ON -> [LlmRoutes]
+# @RELATION: DEPENDS_ON -> [CleanReleaseV2Api]
 # Include API routes
 app.include_router(auth.router)
 app.include_router(admin.router)
 app.include_router(plugins.router, prefix="/api/plugins", tags=["Plugins"])
 app.include_router(tasks.router, prefix="/api/tasks", tags=["Tasks"])
 app.include_router(settings.router, prefix="/api/settings", tags=["Settings"])
-app.include_router(connections.router, prefix="/api/settings/connections", tags=["Connections"])
+app.include_router(
+    connections.router, prefix="/api/settings/connections", tags=["Connections"]
+)
 app.include_router(environments.router, tags=["Environments"])
 app.include_router(mappings.router, prefix="/api/mappings", tags=["Mappings"])
 app.include_router(migration.router)
@@ -212,7 +270,7 @@ app.include_router(clean_release_v2.router)
 app.include_router(profile.router)
 app.include_router(dataset_review.router)
 app.include_router(health.router)
-# [/DEF:api_routes:Block]
+# [/DEF:API_Routes:Block]
 
 
 # [DEF:api.include_routers:Action]
@@ -222,6 +280,7 @@ app.include_router(health.router)
 # @SEMANTICS: routes, registration, api
 # [/DEF:api.include_routers:Action]
 
+
 # [DEF:websocket_endpoint:Function]
 # @COMPLEXITY: 5
 # @PURPOSE: Provides a WebSocket endpoint for real-time log streaming of a task with server-side filtering.
@@ -250,14 +309,11 @@ app.include_router(health.router)
 # @TEST_INVARIANT: consistent_streaming -> verifies: [valid_ws_connection]
 @app.websocket("/ws/logs/{task_id}")
 async def websocket_endpoint(
-    websocket: WebSocket,
-    task_id: str,
-    source: str = None,
-    level: str = None
+    websocket: WebSocket, task_id: str, source: str = None, level: str = None
 ):
     """
     WebSocket endpoint for real-time log streaming with optional server-side filtering.
-    
+
     Query Parameters:
         source: Filter logs by source component (e.g., "plugin", "superset_api")
         level: Filter logs by minimum level (DEBUG, INFO, WARNING, ERROR)
@@ -327,7 +383,9 @@ async def websocket_endpoint(
             task = task_manager.get_task(task_id)
             if task and task.status == "AWAITING_INPUT" and task.input_request:
                 synthetic_log = {
-                    "timestamp": task.logs[-1].timestamp.isoformat() if task.logs else "2024-01-01T00:00:00",
+                    "timestamp": task.logs[-1].timestamp.isoformat()
+                    if task.logs
+                    else "2024-01-01T00:00:00",
                     "level": "INFO",
                     "message": "Task paused for user input (Connection Re-established)",
                     "context": {"input_request": task.input_request},
@@ -355,7 +413,10 @@ async def websocket_endpoint(
                     },
                 )
 
-                if "Task completed successfully" in log_entry.message or "Task failed" in log_entry.message:
+                if (
+                    "Task completed successfully" in log_entry.message
+                    or "Task failed" in log_entry.message
+                ):
                     logger.reason(
                         "Observed terminal task log entry; delaying to preserve client visibility",
                         extra={"task_id": task_id, "message": log_entry.message},
@@ -379,6 +440,8 @@ async def websocket_endpoint(
                 "Released WebSocket log queue subscription",
                 extra={"task_id": task_id},
             )
+
+
 # [/DEF:websocket_endpoint:Function]
 
 # [DEF:StaticFiles:Mount]
@@ -387,7 +450,9 @@ async def websocket_endpoint(
 # @PURPOSE: Mounts the frontend build directory to serve static assets.
 frontend_path = project_root / "frontend" / "build"
 if frontend_path.exists():
-    app.mount("/_app", StaticFiles(directory=str(frontend_path / "_app")), name="static")
+    app.mount(
+        "/_app", StaticFiles(directory=str(frontend_path / "_app")), name="static"
+    )
 
     # [DEF:serve_spa:Function]
     # @COMPLEXITY: 1
@@ -399,15 +464,22 @@ if frontend_path.exists():
         with belief_scope("serve_spa"):
             # Only serve SPA for non-API paths
             # API routes are registered separately and should be matched by FastAPI first
-            if file_path and (file_path.startswith("api/") or file_path.startswith("/api/") or file_path == "api"):
+            if file_path and (
+                file_path.startswith("api/")
+                or file_path.startswith("/api/")
+                or file_path == "api"
+            ):
                 # This should not happen if API routers are properly registered
                 # Return 404 instead of serving HTML
-                raise HTTPException(status_code=404, detail=f"API endpoint not found: {file_path}")
-        
+                raise HTTPException(
+                    status_code=404, detail=f"API endpoint not found: {file_path}"
+                )
+
         full_path = frontend_path / file_path
         if file_path and full_path.is_file():
             return FileResponse(str(full_path))
         return FileResponse(str(frontend_path / "index.html"))
+
     # [/DEF:serve_spa:Function]
 else:
     # [DEF:read_root:Function]
@@ -418,7 +490,10 @@ else:
     @app.get("/")
     async def read_root():
         with belief_scope("read_root"):
-            return {"message": "Superset Tools API is running (Frontend build not found)"}
+            return {
+                "message": "Superset Tools API is running (Frontend build not found)"
+            }
+
     # [/DEF:read_root:Function]
 # [/DEF:StaticFiles:Mount]
 # [/DEF:AppModule:Module]
diff --git a/backend/src/core/config_models.py b/backend/src/core/config_models.py
index 83115b8e..1c895436 100755
--- a/backend/src/core/config_models.py
+++ b/backend/src/core/config_models.py
@@ -1,10 +1,10 @@
-# [DEF:backend.src.core.config_models:Module]
+# [DEF:ConfigModels:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: config, models, pydantic
 # @PURPOSE: Defines the data models for application configuration using Pydantic.
 # @LAYER: Core
-# @RELATION: READS_FROM -> app_configurations (database)
-# @RELATION: USED_BY -> ConfigManager
+# @RELATION: IMPLEMENTS -> [CoreContracts]
+# @RELATION: IMPLEMENTS -> [ConnectionContracts]
 
 from pydantic import BaseModel, Field
 from typing import List, Optional
@@ -15,14 +15,18 @@ from ..services.llm_prompt_templates import (
     DEFAULT_LLM_PROVIDER_BINDINGS,
 )
 
+
 # [DEF:Schedule:DataClass]
 # @PURPOSE: Represents a backup schedule configuration.
 class Schedule(BaseModel):
     enabled: bool = False
     cron_expression: str = "0 0 * * *"  # Default: daily at midnight
+
+
 # [/DEF:Schedule:DataClass]
 
-# [DEF:backend.src.core.config_models.Environment:DataClass]
+
+# [DEF:Environment:DataClass]
 # @PURPOSE: Represents a Superset environment configuration.
 class Environment(BaseModel):
     id: str
@@ -36,26 +40,37 @@ class Environment(BaseModel):
     is_default: bool = False
     is_production: bool = False
     backup_schedule: Schedule = Field(default_factory=Schedule)
-# [/DEF:backend.src.core.config_models.Environment:DataClass]
+
+
+# [/DEF:Environment:DataClass]
+
 
 # [DEF:LoggingConfig:DataClass]
 # @PURPOSE: Defines the configuration for the application's logging system.
 class LoggingConfig(BaseModel):
     level: str = "INFO"
-    task_log_level: str = "INFO"  # Minimum level for task-specific logs (DEBUG, INFO, WARNING, ERROR)
+    task_log_level: str = (
+        "INFO"  # Minimum level for task-specific logs (DEBUG, INFO, WARNING, ERROR)
+    )
     file_path: Optional[str] = None
     max_bytes: int = 10 * 1024 * 1024
     backup_count: int = 5
     enable_belief_state: bool = True
+
+
 # [/DEF:LoggingConfig:DataClass]
 
+
 # [DEF:CleanReleaseConfig:DataClass]
 # @PURPOSE: Configuration for clean release compliance subsystem.
 class CleanReleaseConfig(BaseModel):
     active_policy_id: Optional[str] = None
     active_registry_id: Optional[str] = None
+
+
 # [/DEF:CleanReleaseConfig:DataClass]
 
+
 # [DEF:GlobalSettings:DataClass]
 # @PURPOSE: Represents global application settings.
 class GlobalSettings(BaseModel):
@@ -73,12 +88,12 @@ class GlobalSettings(BaseModel):
             **dict(DEFAULT_LLM_ASSISTANT_SETTINGS),
         }
     )
-    
+
     # Task retention settings
     task_retention_days: int = 30
     task_retention_limit: int = 100
     pagination_limit: int = 10
-    
+
     # Migration sync settings
     migration_sync_cron: str = "0 2 * * *"
 
@@ -86,13 +101,18 @@ class GlobalSettings(BaseModel):
     ff_dataset_auto_review: bool = True
     ff_dataset_clarification: bool = True
     ff_dataset_execution: bool = True
+
+
 # [/DEF:GlobalSettings:DataClass]
 
+
 # [DEF:AppConfig:DataClass]
 # @PURPOSE: The root configuration model containing all application settings.
 class AppConfig(BaseModel):
     environments: List[Environment] = []
     settings: GlobalSettings
+
+
 # [/DEF:AppConfig:DataClass]
 
 # [/DEF:ConfigModels:Module]
diff --git a/backend/src/core/superset_client.py b/backend/src/core/superset_client.py
index e633f2bf..92d91dd1 100644
--- a/backend/src/core/superset_client.py
+++ b/backend/src/core/superset_client.py
@@ -4,7 +4,8 @@
 # @SEMANTICS: superset, api, client, rest, http, dashboard, dataset, import, export
 # @PURPOSE:   Предоставляет высокоуровневый клиент для взаимодействия с Superset REST API, инкапсулируя логику запросов, обработку ошибок и пагинацию.
 # @LAYER:     Core
-# @RELATION: [DEPENDS_ON] ->[APIClient.__init__]
+# @RELATION: DEPENDS_ON -> [ConfigModels]
+# @RELATION: DEPENDS_ON -> [ConnectionContracts]
 #
 # @INVARIANT: All network operations must use the internal APIClient instance.
 # @PUBLIC_API: SupersetClient
@@ -30,16 +31,17 @@ app_logger = cast(Any, app_logger)
 # [DEF:SupersetClient:Class]
 # @COMPLEXITY: 3
 # @PURPOSE: Класс-обёртка над Superset REST API, предоставляющий методы для работы с дашбордами и датасетами.
-# @RELATION: [DEPENDS_ON] ->[APIClient]
+# @RELATION: DEPENDS_ON -> [ConfigModels]
+# @RELATION: DEPENDS_ON -> [ConnectionContracts]
 class SupersetClient:
-    # [DEF:SupersetClient.__init__:Function]
+    # [DEF:SupersetClientInit:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Инициализирует клиент, проверяет конфигурацию и создает сетевой клиент.
     # @PRE:  `env` должен быть валидным объектом Environment.
     # @POST: Атрибуты `env` и `network` созданы и готовы к работе.
     # @DATA_CONTRACT: Input[Environment] -> self.network[APIClient]
-    # @RELATION: [DEPENDS_ON] ->[Environment]
-    # @RELATION: [DEPENDS_ON] ->[APIClient.__init__]
+    # @RELATION: DEPENDS_ON -> [Environment]
+    # @RELATION: DEPENDS_ON -> [ConnectionContracts]
     def __init__(self, env: Environment):
         with belief_scope("__init__"):
             app_logger.info(
@@ -62,23 +64,23 @@ class SupersetClient:
         self.delete_before_reimport: bool = False
         app_logger.info("[SupersetClient.__init__][Exit] SupersetClient initialized.")
 
-    # [/DEF:SupersetClient.__init__:Function]
+    # [/DEF:SupersetClientInit:Function]
 
-    # [DEF:SupersetClient.authenticate:Function]
+    # [DEF:SupersetClientAuthenticate:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Authenticates the client using the configured credentials.
     # @PRE: self.network must be initialized with valid auth configuration.
     # @POST: Client is authenticated and tokens are stored.
     # @DATA_CONTRACT: None -> Output[Dict[str, str]]
-    # @RELATION: [CALLS] ->[APIClient.authenticate]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def authenticate(self) -> Dict[str, str]:
         with belief_scope("SupersetClient.authenticate"):
             return self.network.authenticate()
 
-    # [/DEF:SupersetClient.authenticate:Function]
+    # [/DEF:SupersetClientAuthenticate:Function]
 
     @property
-    # [DEF:SupersetClient.headers:Function]
+    # [DEF:SupersetClientHeaders:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Возвращает базовые HTTP-заголовки, используемые сетевым клиентом.
     # @PRE: APIClient is initialized and authenticated.
@@ -87,17 +89,17 @@ class SupersetClient:
         with belief_scope("headers"):
             return self.network.headers
 
-    # [/DEF:SupersetClient.headers:Function]
+    # [/DEF:SupersetClientHeaders:Function]
 
     # [SECTION: DASHBOARD OPERATIONS]
 
-    # [DEF:SupersetClient.get_dashboards:Function]
+    # [DEF:SupersetClientGetDashboards:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Получает полный список дашбордов, автоматически обрабатывая пагинацию.
     # @PRE: Client is authenticated.
     # @POST: Returns a tuple with total count and list of dashboards.
     # @DATA_CONTRACT: Input[query: Optional[Dict]] -> Output[Tuple[int, List[Dict]]]
-    # @RELATION: [CALLS] ->[_fetch_all_pages]
+    # @RELATION: CALLS -> [SupersetClientFetchAllPages]
     def get_dashboards(self, query: Optional[Dict] = None) -> Tuple[int, List[Dict]]:
         with belief_scope("get_dashboards"):
             app_logger.info("[get_dashboards][Enter] Fetching dashboards.")
@@ -127,15 +129,15 @@ class SupersetClient:
             app_logger.info("[get_dashboards][Exit] Found %d dashboards.", total_count)
             return total_count, paginated_data
 
-    # [/DEF:SupersetClient.get_dashboards:Function]
+    # [/DEF:SupersetClientGetDashboards:Function]
 
-    # [DEF:SupersetClient.get_dashboards_page:Function]
+    # [DEF:SupersetClientGetDashboardsPage:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches a single dashboards page from Superset without iterating all pages.
     # @PRE: Client is authenticated.
     # @POST: Returns total count and one page of dashboards.
     # @DATA_CONTRACT: Input[query: Optional[Dict]] -> Output[Tuple[int, List[Dict]]]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_dashboards_page(
         self, query: Optional[Dict] = None
     ) -> Tuple[int, List[Dict]]:
@@ -167,15 +169,15 @@ class SupersetClient:
             total_count = response_json.get("count", len(result))
             return total_count, result
 
-    # [/DEF:SupersetClient.get_dashboards_page:Function]
+    # [/DEF:SupersetClientGetDashboardsPage:Function]
 
-    # [DEF:SupersetClient.get_dashboards_summary:Function]
+    # [DEF:SupersetClientGetDashboardsSummary:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches dashboard metadata optimized for the grid.
     # @PRE: Client is authenticated.
     # @POST: Returns a list of dashboard metadata summaries.
     # @DATA_CONTRACT: None -> Output[List[Dict]]
-    # @RELATION: [CALLS] ->[SupersetClient.get_dashboards]
+    # @RELATION: CALLS -> [SupersetClientGetDashboards]
     def get_dashboards_summary(self, require_slug: bool = False) -> List[Dict]:
         with belief_scope("SupersetClient.get_dashboards_summary"):
             # Rely on list endpoint default projection to stay compatible
@@ -257,15 +259,15 @@ class SupersetClient:
             )
             return result
 
-    # [/DEF:SupersetClient.get_dashboards_summary:Function]
+    # [/DEF:SupersetClientGetDashboardsSummary:Function]
 
-    # [DEF:SupersetClient.get_dashboards_summary_page:Function]
+    # [DEF:SupersetClientGetDashboardsSummaryPage:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches one page of dashboard metadata optimized for the grid.
     # @PRE: page >= 1 and page_size > 0.
     # @POST: Returns mapped summaries and total dashboard count.
     # @DATA_CONTRACT: Input[page: int, page_size: int] -> Output[Tuple[int, List[Dict]]]
-    # @RELATION: [CALLS] ->[SupersetClient.get_dashboards_page]
+    # @RELATION: CALLS -> [SupersetClientGetDashboardsPage]
     def get_dashboards_summary_page(
         self,
         page: int,
@@ -333,9 +335,9 @@ class SupersetClient:
 
             return total_count, result
 
-    # [/DEF:SupersetClient.get_dashboards_summary_page:Function]
+    # [/DEF:SupersetClientGetDashboardsSummaryPage:Function]
 
-    # [DEF:SupersetClient._extract_owner_labels:Function]
+    # [DEF:SupersetClientExtractOwnerLabels:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Normalize dashboard owners payload to stable display labels.
     # @PRE: owners payload can be scalar, object or list.
@@ -362,9 +364,9 @@ class SupersetClient:
                 normalized.append(label)
         return normalized
 
-    # [/DEF:SupersetClient._extract_owner_labels:Function]
+    # [/DEF:SupersetClientExtractOwnerLabels:Function]
 
-    # [DEF:SupersetClient._extract_user_display:Function]
+    # [DEF:SupersetClientExtractUserDisplay:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Normalize user payload to a stable display name.
     # @PRE: user payload can be string, dict or None.
@@ -396,9 +398,9 @@ class SupersetClient:
                 return email
         return None
 
-    # [/DEF:SupersetClient._extract_user_display:Function]
+    # [/DEF:SupersetClientExtractUserDisplay:Function]
 
-    # [DEF:SupersetClient._sanitize_user_text:Function]
+    # [DEF:SupersetClientSanitizeUserText:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Convert scalar value to non-empty user-facing text.
     # @PRE: value can be any scalar type.
@@ -411,15 +413,15 @@ class SupersetClient:
             return None
         return normalized
 
-    # [/DEF:SupersetClient._sanitize_user_text:Function]
+    # [/DEF:SupersetClientSanitizeUserText:Function]
 
-    # [DEF:SupersetClient.get_dashboard:Function]
+    # [DEF:SupersetClientGetDashboard:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches a single dashboard by ID or slug.
     # @PRE: Client is authenticated and dashboard_ref exists.
     # @POST: Returns dashboard payload from Superset API.
     # @DATA_CONTRACT: Input[dashboard_ref: Union[int, str]] -> Output[Dict]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_dashboard(self, dashboard_ref: Union[int, str]) -> Dict:
         with belief_scope("SupersetClient.get_dashboard", f"ref={dashboard_ref}"):
             response = self.network.request(
@@ -427,15 +429,15 @@ class SupersetClient:
             )
             return cast(Dict, response)
 
-    # [/DEF:SupersetClient.get_dashboard:Function]
+    # [/DEF:SupersetClientGetDashboard:Function]
 
-    # [DEF:SupersetClient.get_dashboard_permalink_state:Function]
+    # [DEF:SupersetClientGetDashboardPermalinkState:Function]
     # @COMPLEXITY: 2
     # @PURPOSE: Fetches stored dashboard permalink state by permalink key.
     # @PRE: Client is authenticated and permalink key exists.
     # @POST: Returns dashboard permalink state payload from Superset API.
     # @DATA_CONTRACT: Input[permalink_key: str] -> Output[Dict]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_dashboard_permalink_state(self, permalink_key: str) -> Dict:
         with belief_scope(
             "SupersetClient.get_dashboard_permalink_state", f"key={permalink_key}"
@@ -445,15 +447,15 @@ class SupersetClient:
             )
             return cast(Dict, response)
 
-    # [/DEF:SupersetClient.get_dashboard_permalink_state:Function]
+    # [/DEF:SupersetClientGetDashboardPermalinkState:Function]
 
-    # [DEF:SupersetClient.get_native_filter_state:Function]
+    # [DEF:SupersetClientGetNativeFilterState:Function]
     # @COMPLEXITY: 2
     # @PURPOSE: Fetches stored native filter state by filter state key.
     # @PRE: Client is authenticated and filter_state_key exists.
     # @POST: Returns native filter state payload from Superset API.
     # @DATA_CONTRACT: Input[dashboard_id: Union[int, str], filter_state_key: str] -> Output[Dict]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_native_filter_state(
         self, dashboard_id: Union[int, str], filter_state_key: str
     ) -> Dict:
@@ -467,15 +469,15 @@ class SupersetClient:
             )
             return cast(Dict, response)
 
-    # [/DEF:SupersetClient.get_native_filter_state:Function]
+    # [/DEF:SupersetClientGetNativeFilterState:Function]
 
-    # [DEF:SupersetClient.extract_native_filters_from_permalink:Function]
+    # [DEF:SupersetClientExtractNativeFiltersFromPermalink:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Extract native filters dataMask from a permalink key.
     # @PRE: Client is authenticated and permalink_key exists.
     # @POST: Returns extracted dataMask with filter states.
     # @DATA_CONTRACT: Input[permalink_key: str] -> Output[Dict]
-    # @RELATION: [CALLS] ->[SupersetClient.get_dashboard_permalink_state]
+    # @RELATION: CALLS -> [SupersetClientGetDashboardPermalinkState]
     def extract_native_filters_from_permalink(self, permalink_key: str) -> Dict:
         with belief_scope(
             "SupersetClient.extract_native_filters_from_permalink",
@@ -507,15 +509,15 @@ class SupersetClient:
                 "permalink_key": permalink_key,
             }
 
-    # [/DEF:SupersetClient.extract_native_filters_from_permalink:Function]
+    # [/DEF:SupersetClientExtractNativeFiltersFromPermalink:Function]
 
-    # [DEF:SupersetClient.extract_native_filters_from_key:Function]
+    # [DEF:SupersetClientExtractNativeFiltersFromKey:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Extract native filters from a native_filters_key URL parameter.
     # @PRE: Client is authenticated, dashboard_id and filter_state_key exist.
     # @POST: Returns extracted filter state with extraFormData.
     # @DATA_CONTRACT: Input[dashboard_id: Union[int, str], filter_state_key: str] -> Output[Dict]
-    # @RELATION: [CALLS] ->[SupersetClient.get_native_filter_state]
+    # @RELATION: CALLS -> [SupersetClientGetNativeFilterState]
     def extract_native_filters_from_key(
         self, dashboard_id: Union[int, str], filter_state_key: str
     ) -> Dict:
@@ -576,16 +578,16 @@ class SupersetClient:
                 "filter_state_key": filter_state_key,
             }
 
-    # [/DEF:SupersetClient.extract_native_filters_from_key:Function]
+    # [/DEF:SupersetClientExtractNativeFiltersFromKey:Function]
 
-    # [DEF:SupersetClient.parse_dashboard_url_for_filters:Function]
+    # [DEF:SupersetClientParseDashboardUrlForFilters:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Parse a Superset dashboard URL and extract native filter state if present.
     # @PRE: url must be a valid Superset dashboard URL with optional permalink or native_filters_key.
     # @POST: Returns extracted filter state or empty dict if no filters found.
     # @DATA_CONTRACT: Input[url: str] -> Output[Dict]
-    # @RELATION: [CALLS] ->[SupersetClient.extract_native_filters_from_permalink]
-    # @RELATION: [CALLS] ->[SupersetClient.extract_native_filters_from_key]
+    # @RELATION: CALLS -> [SupersetClientExtractNativeFiltersFromPermalink]
+    # @RELATION: CALLS -> [SupersetClientExtractNativeFiltersFromKey]
     def parse_dashboard_url_for_filters(self, url: str) -> Dict:
         with belief_scope(
             "SupersetClient.parse_dashboard_url_for_filters", f"url={url}"
@@ -686,30 +688,30 @@ class SupersetClient:
 
             return result
 
-    # [/DEF:SupersetClient.parse_dashboard_url_for_filters:Function]
+    # [/DEF:SupersetClientParseDashboardUrlForFilters:Function]
 
-    # [DEF:SupersetClient.get_chart:Function]
+    # [DEF:SupersetClientGetChart:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches a single chart by ID.
     # @PRE: Client is authenticated and chart_id exists.
     # @POST: Returns chart payload from Superset API.
     # @DATA_CONTRACT: Input[chart_id: int] -> Output[Dict]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_chart(self, chart_id: int) -> Dict:
         with belief_scope("SupersetClient.get_chart", f"id={chart_id}"):
             response = self.network.request(method="GET", endpoint=f"/chart/{chart_id}")
             return cast(Dict, response)
 
-    # [/DEF:SupersetClient.get_chart:Function]
+    # [/DEF:SupersetClientGetChart:Function]
 
-    # [DEF:SupersetClient.get_dashboard_detail:Function]
+    # [DEF:SupersetClientGetDashboardDetail:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches detailed dashboard information including related charts and datasets.
     # @PRE: Client is authenticated and dashboard reference exists.
     # @POST: Returns dashboard metadata with charts and datasets lists.
     # @DATA_CONTRACT: Input[dashboard_ref: Union[int, str]] -> Output[Dict]
-    # @RELATION: [CALLS] ->[SupersetClient.get_dashboard]
-    # @RELATION: [CALLS] ->[SupersetClient.get_chart]
+    # @RELATION: CALLS -> [SupersetClientGetDashboard]
+    # @RELATION: CALLS -> [SupersetClientGetChart]
     def get_dashboard_detail(self, dashboard_ref: Union[int, str]) -> Dict:
         with belief_scope(
             "SupersetClient.get_dashboard_detail", f"ref={dashboard_ref}"
@@ -988,15 +990,15 @@ class SupersetClient:
                 "dataset_count": len(unique_datasets),
             }
 
-    # [/DEF:SupersetClient.get_dashboard_detail:Function]
+    # [/DEF:SupersetClientGetDashboardDetail:Function]
 
-    # [DEF:SupersetClient.get_charts:Function]
+    # [DEF:SupersetClientGetCharts:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches all charts with pagination support.
     # @PRE: Client is authenticated.
     # @POST: Returns total count and charts list.
     # @DATA_CONTRACT: Input[query: Optional[Dict]] -> Output[Tuple[int, List[Dict]]]
-    # @RELATION: [CALLS] ->[_fetch_all_pages]
+    # @RELATION: CALLS -> [SupersetClientFetchAllPages]
     def get_charts(self, query: Optional[Dict] = None) -> Tuple[int, List[Dict]]:
         with belief_scope("get_charts"):
             validated_query = self._validate_query_params(query or {})
@@ -1012,9 +1014,9 @@ class SupersetClient:
             )
             return len(paginated_data), paginated_data
 
-    # [/DEF:SupersetClient.get_charts:Function]
+    # [/DEF:SupersetClientGetCharts:Function]
 
-    # [DEF:SupersetClient._extract_chart_ids_from_layout:Function]
+    # [DEF:SupersetClientExtractChartIdsFromLayout:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Traverses dashboard layout metadata and extracts chart IDs from common keys.
     # @PRE: payload can be dict/list/scalar.
@@ -1048,16 +1050,16 @@ class SupersetClient:
             walk(payload)
             return found
 
-    # [/DEF:SupersetClient._extract_chart_ids_from_layout:Function]
+    # [/DEF:SupersetClientExtractChartIdsFromLayout:Function]
 
-    # [DEF:export_dashboard:Function]
+    # [DEF:SupersetClientExportDashboard:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Экспортирует дашборд в виде ZIP-архива.
     # @PRE: dashboard_id must exist in Superset.
     # @POST: Returns ZIP content and filename.
     # @DATA_CONTRACT: Input[dashboard_id: int] -> Output[Tuple[bytes, str]]
     # @SIDE_EFFECT: Performs network I/O to download archive.
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def export_dashboard(self, dashboard_id: int) -> Tuple[bytes, str]:
         with belief_scope("export_dashboard"):
             app_logger.info(
@@ -1080,17 +1082,17 @@ class SupersetClient:
             )
             return response.content, filename
 
-    # [/DEF:export_dashboard:Function]
+    # [/DEF:SupersetClientExportDashboard:Function]
 
-    # [DEF:import_dashboard:Function]
+    # [DEF:SupersetClientImportDashboard:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Импортирует дашборд из ZIP-файла.
     # @PRE: file_name must be a valid ZIP dashboard export.
     # @POST: Dashboard is imported or re-imported after deletion.
     # @DATA_CONTRACT: Input[file_name: Union[str, Path]] -> Output[Dict]
     # @SIDE_EFFECT: Performs network I/O to upload archive.
-    # @RELATION: [CALLS] ->[SupersetClient._do_import]
-    # @RELATION: [CALLS] ->[delete_dashboard]
+    # @RELATION: CALLS -> [SupersetClientDoImport]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def import_dashboard(
         self,
         file_name: Union[str, Path],
@@ -1127,15 +1129,15 @@ class SupersetClient:
                 )
                 return self._do_import(file_path)
 
-    # [/DEF:import_dashboard:Function]
+    # [/DEF:SupersetClientImportDashboard:Function]
 
-    # [DEF:delete_dashboard:Function]
+    # [DEF:SupersetClientDeleteDashboard:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Удаляет дашборд по его ID или slug.
     # @PRE: dashboard_id must exist.
     # @POST: Dashboard is removed from Superset.
     # @SIDE_EFFECT: Deletes resource from upstream Superset environment.
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def delete_dashboard(self, dashboard_id: Union[int, str]) -> None:
         with belief_scope("delete_dashboard"):
             app_logger.info(
@@ -1156,15 +1158,15 @@ class SupersetClient:
                     response,
                 )
 
-    # [/DEF:delete_dashboard:Function]
+    # [/DEF:SupersetClientDeleteDashboard:Function]
 
-    # [DEF:SupersetClient.get_datasets:Function]
+    # [DEF:SupersetClientGetDatasets:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Получает полный список датасетов, автоматически обрабатывая пагинацию.
     # @PRE: Client is authenticated.
     # @POST: Returns total count and list of datasets.
     # @DATA_CONTRACT: Input[query: Optional[Dict]] -> Output[Tuple[int, List[Dict]]]
-    # @RELATION: [CALLS] ->[_fetch_all_pages]
+    # @RELATION: CALLS -> [SupersetClientFetchAllPages]
     def get_datasets(self, query: Optional[Dict] = None) -> Tuple[int, List[Dict]]:
         with belief_scope("get_datasets"):
             app_logger.info("[get_datasets][Enter] Fetching datasets.")
@@ -1181,15 +1183,15 @@ class SupersetClient:
             app_logger.info("[get_datasets][Exit] Found %d datasets.", total_count)
             return total_count, paginated_data
 
-    # [/DEF:SupersetClient.get_datasets:Function]
+    # [/DEF:SupersetClientGetDatasets:Function]
 
-    # [DEF:SupersetClient.get_datasets_summary:Function]
+    # [DEF:SupersetClientGetDatasetsSummary:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches dataset metadata optimized for the Dataset Hub grid.
     # @PRE: Client is authenticated.
     # @POST: Returns a list of dataset metadata summaries.
     # @RETURN: List[Dict]
-    # @RELATION: [CALLS] ->[SupersetClient.get_datasets]
+    # @RELATION: CALLS -> [SupersetClientGetDatasets]
     def get_datasets_summary(self) -> List[Dict]:
         with belief_scope("SupersetClient.get_datasets_summary"):
             query = {"columns": ["id", "table_name", "schema", "database"]}
@@ -1210,17 +1212,17 @@ class SupersetClient:
                 )
             return result
 
-    # [/DEF:SupersetClient.get_datasets_summary:Function]
+    # [/DEF:SupersetClientGetDatasetsSummary:Function]
 
-    # [DEF:get_dataset_detail:Function]
+    # [DEF:SupersetClientGetDatasetDetail:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches detailed dataset information including columns and linked dashboards
     # @PRE: Client is authenticated and dataset_id exists.
     # @POST: Returns detailed dataset info with columns and linked dashboards.
     # @PARAM: dataset_id (int) - The dataset ID to fetch details for.
     # @RETURN: Dict - Dataset details with columns and linked_dashboards.
-    # @RELATION: [CALLS] ->[SupersetClient.get_dataset]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [SupersetClientGetDataset]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_dataset_detail(self, dataset_id: int) -> Dict:
         with belief_scope("SupersetClient.get_dataset_detail", f"id={dataset_id}"):
 
@@ -1339,15 +1341,15 @@ class SupersetClient:
             )
             return result
 
-    # [/DEF:get_dataset_detail:Function]
+    # [/DEF:SupersetClientGetDatasetDetail:Function]
 
-    # [DEF:SupersetClient.get_dataset:Function]
+    # [DEF:SupersetClientGetDataset:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Получает информацию о конкретном датасете по его ID.
     # @PRE: dataset_id must exist.
     # @POST: Returns dataset details.
     # @DATA_CONTRACT: Input[dataset_id: int] -> Output[Dict]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_dataset(self, dataset_id: int) -> Dict:
         with belief_scope("SupersetClient.get_dataset", f"id={dataset_id}"):
             app_logger.info("[get_dataset][Enter] Fetching dataset %s.", dataset_id)
@@ -1358,19 +1360,19 @@ class SupersetClient:
             app_logger.info("[get_dataset][Exit] Got dataset %s.", dataset_id)
             return response
 
-    # [/DEF:SupersetClient.get_dataset:Function]
+    # [/DEF:SupersetClientGetDataset:Function]
 
-    # [DEF:SupersetClient.compile_dataset_preview:Function]
+    # [DEF:SupersetClientCompileDatasetPreview:Function]
     # @COMPLEXITY: 4
     # @PURPOSE: Compile dataset preview SQL through the strongest supported Superset preview endpoint family and return normalized SQL output.
     # @PRE: dataset_id must be valid and template_params/effective_filters must represent the current preview session inputs.
     # @POST: Returns normalized compiled SQL plus raw upstream response, preferring legacy form_data transport with explicit fallback to chart-data.
     # @DATA_CONTRACT: Input[dataset_id:int, template_params:Dict, effective_filters:List[Dict]] -> Output[Dict[str, Any]]
-    # @RELATION: [CALLS] ->[SupersetClient.get_dataset]
-    # @RELATION: [CALLS] ->[SupersetClient.build_dataset_preview_query_context]
-    # @RELATION: [CALLS] ->[SupersetClient.build_dataset_preview_legacy_form_data]
-    # @RELATION: [CALLS] ->[request]
-    # @RELATION: [CALLS] ->[_extract_compiled_sql_from_preview_response]
+    # @RELATION: CALLS -> [SupersetClientGetDataset]
+    # @RELATION: CALLS -> [SupersetClientBuildDatasetPreviewQueryContext]
+    # @RELATION: CALLS -> [SupersetClientBuildDatasetPreviewLegacyFormData]
+    # @RELATION: CALLS -> [ConnectionContracts]
+    # @RELATION: CALLS -> [SupersetClientExtractCompiledSqlFromPreviewResponse]
     # @SIDE_EFFECT: Performs upstream dataset lookup and preview network I/O against Superset.
     def compile_dataset_preview(
         self,
@@ -1535,15 +1537,15 @@ class SupersetClient:
                 f"(attempts={strategy_attempts!r})"
             )
 
-    # [/DEF:SupersetClient.compile_dataset_preview:Function]
+    # [/DEF:SupersetClientCompileDatasetPreview:Function]
 
-    # [DEF:SupersetClient.build_dataset_preview_legacy_form_data:Function]
+    # [DEF:SupersetClientBuildDatasetPreviewLegacyFormData:Function]
     # @COMPLEXITY: 4
     # @PURPOSE: Build browser-style legacy form_data payload for Superset preview endpoints inferred from observed deployment traffic.
     # @PRE: dataset_record should come from Superset dataset detail when possible.
     # @POST: Returns one serialized-ready form_data structure preserving native filter clauses in legacy transport fields.
     # @DATA_CONTRACT: Input[dataset_id:int,dataset_record:Dict,template_params:Dict,effective_filters:List[Dict]] -> Output[Dict[str, Any]]
-    # @RELATION: [CALLS] ->[SupersetClient.build_dataset_preview_query_context]
+    # @RELATION: CALLS -> [SupersetClientBuildDatasetPreviewQueryContext]
     # @SIDE_EFFECT: Emits reasoning diagnostics describing the inferred legacy payload shape.
     def build_dataset_preview_legacy_form_data(
         self,
@@ -1611,15 +1613,15 @@ class SupersetClient:
             )
             return legacy_form_data
 
-    # [/DEF:SupersetClient.build_dataset_preview_legacy_form_data:Function]
+    # [/DEF:SupersetClientBuildDatasetPreviewLegacyFormData:Function]
 
-    # [DEF:SupersetClient.build_dataset_preview_query_context:Function]
+    # [DEF:SupersetClientBuildDatasetPreviewQueryContext:Function]
     # @COMPLEXITY: 4
     # @PURPOSE: Build a reduced-scope chart-data query context for deterministic dataset preview compilation.
     # @PRE: dataset_record should come from Superset dataset detail when possible.
     # @POST: Returns an explicit chart-data payload based on current session inputs and dataset metadata.
     # @DATA_CONTRACT: Input[dataset_id:int,dataset_record:Dict,template_params:Dict,effective_filters:List[Dict]] -> Output[Dict[str, Any]]
-    # @RELATION: [CALLS] ->[_normalize_effective_filters_for_query_context]
+    # @RELATION: CALLS -> [SupersetClientNormalizeEffectiveFiltersForQueryContext]
     # @SIDE_EFFECT: Emits reasoning and reflection logs for deterministic preview payload construction.
     def build_dataset_preview_query_context(
         self,
@@ -1740,14 +1742,14 @@ class SupersetClient:
             )
             return payload
 
-    # [/DEF:SupersetClient.build_dataset_preview_query_context:Function]
+    # [/DEF:SupersetClientBuildDatasetPreviewQueryContext:Function]
 
-    # [DEF:_normalize_effective_filters_for_query_context:Function]
+    # [DEF:SupersetClientNormalizeEffectiveFiltersForQueryContext:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Convert execution mappings into Superset chart-data filter objects.
     # @PRE: effective_filters may contain mapping metadata and arbitrary scalar/list values.
     # @POST: Returns only valid filter dictionaries suitable for the chart-data query payload.
-    # @RELATION: [DEPENDS_ON] ->[FilterStateModels]
+    # @RELATION: DEPENDS_ON -> [CoreContracts]
     def _normalize_effective_filters_for_query_context(
         self,
         effective_filters: List[Dict[str, Any]],
@@ -1850,14 +1852,14 @@ class SupersetClient:
                 "diagnostics": diagnostics,
             }
 
-    # [/DEF:_normalize_effective_filters_for_query_context:Function]
+    # [/DEF:SupersetClientNormalizeEffectiveFiltersForQueryContext:Function]
 
-    # [DEF:_extract_compiled_sql_from_preview_response:Function]
+    # [DEF:SupersetClientExtractCompiledSqlFromPreviewResponse:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Normalize compiled SQL from either chart-data or legacy form_data preview responses.
     # @PRE: response must be the decoded preview response body from a supported Superset endpoint.
     # @POST: Returns compiled SQL and raw response or raises SupersetAPIError when the endpoint does not expose query text.
-    # @RELATION: [DEPENDS_ON] ->[SupersetAPIError]
+    # @RELATION: DEPENDS_ON -> [ConnectionContracts]
     def _extract_compiled_sql_from_preview_response(
         self, response: Any
     ) -> Dict[str, Any]:
@@ -1930,16 +1932,16 @@ class SupersetClient:
                 f"(diagnostics={response_diagnostics!r})"
             )
 
-    # [/DEF:_extract_compiled_sql_from_preview_response:Function]
+    # [/DEF:SupersetClientExtractCompiledSqlFromPreviewResponse:Function]
 
-    # [DEF:SupersetClient.update_dataset:Function]
+    # [DEF:SupersetClientUpdateDataset:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Обновляет данные датасета по его ID.
     # @PRE: dataset_id must exist.
     # @POST: Dataset is updated in Superset.
     # @DATA_CONTRACT: Input[dataset_id: int, data: Dict] -> Output[Dict]
     # @SIDE_EFFECT: Modifies resource in upstream Superset environment.
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def update_dataset(self, dataset_id: int, data: Dict) -> Dict:
         with belief_scope("SupersetClient.update_dataset", f"id={dataset_id}"):
             app_logger.info("[update_dataset][Enter] Updating dataset %s.", dataset_id)
@@ -1953,15 +1955,15 @@ class SupersetClient:
             app_logger.info("[update_dataset][Exit] Updated dataset %s.", dataset_id)
             return response
 
-    # [/DEF:SupersetClient.update_dataset:Function]
+    # [/DEF:SupersetClientUpdateDataset:Function]
 
-    # [DEF:SupersetClient.get_databases:Function]
+    # [DEF:SupersetClientGetDatabases:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Получает полный список баз данных.
     # @PRE: Client is authenticated.
     # @POST: Returns total count and list of databases.
     # @DATA_CONTRACT: Input[query: Optional[Dict]] -> Output[Tuple[int, List[Dict]]]
-    # @RELATION: [CALLS] ->[_fetch_all_pages]
+    # @RELATION: CALLS -> [SupersetClientFetchAllPages]
     def get_databases(self, query: Optional[Dict] = None) -> Tuple[int, List[Dict]]:
         with belief_scope("get_databases"):
             app_logger.info("[get_databases][Enter] Fetching databases.")
@@ -1980,15 +1982,15 @@ class SupersetClient:
             app_logger.info("[get_databases][Exit] Found %d databases.", total_count)
             return total_count, paginated_data
 
-    # [/DEF:SupersetClient.get_databases:Function]
+    # [/DEF:SupersetClientGetDatabases:Function]
 
-    # [DEF:get_database:Function]
+    # [DEF:SupersetClientGetDatabase:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Получает информацию о конкретной базе данных по её ID.
     # @PRE: database_id must exist.
     # @POST: Returns database details.
     # @DATA_CONTRACT: Input[database_id: int] -> Output[Dict]
-    # @RELATION: [CALLS] ->[request]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def get_database(self, database_id: int) -> Dict:
         with belief_scope("get_database"):
             app_logger.info("[get_database][Enter] Fetching database %s.", database_id)
@@ -1999,15 +2001,15 @@ class SupersetClient:
             app_logger.info("[get_database][Exit] Got database %s.", database_id)
             return response
 
-    # [/DEF:get_database:Function]
+    # [/DEF:SupersetClientGetDatabase:Function]
 
-    # [DEF:get_databases_summary:Function]
+    # [DEF:SupersetClientGetDatabasesSummary:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetch a summary of databases including uuid, name, and engine.
     # @PRE: Client is authenticated.
     # @POST: Returns list of database summaries.
     # @DATA_CONTRACT: None -> Output[List[Dict]]
-    # @RELATION: [CALLS] ->[SupersetClient.get_databases]
+    # @RELATION: CALLS -> [SupersetClientGetDatabases]
     def get_databases_summary(self) -> List[Dict]:
         with belief_scope("SupersetClient.get_databases_summary"):
             query = {"columns": ["uuid", "database_name", "backend"]}
@@ -2019,29 +2021,29 @@ class SupersetClient:
 
             return databases
 
-    # [/DEF:get_databases_summary:Function]
+    # [/DEF:SupersetClientGetDatabasesSummary:Function]
 
-    # [DEF:get_database_by_uuid:Function]
+    # [DEF:SupersetClientGetDatabaseByUuid:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Find a database by its UUID.
     # @PRE: db_uuid must be a valid UUID string.
     # @POST: Returns database info or None.
     # @DATA_CONTRACT: Input[db_uuid: str] -> Output[Optional[Dict]]
-    # @RELATION: [CALLS] ->[SupersetClient.get_databases]
+    # @RELATION: CALLS -> [SupersetClientGetDatabases]
     def get_database_by_uuid(self, db_uuid: str) -> Optional[Dict]:
         with belief_scope("SupersetClient.get_database_by_uuid", f"uuid={db_uuid}"):
             query = {"filters": [{"col": "uuid", "op": "eq", "value": db_uuid}]}
             _, databases = self.get_databases(query=query)
             return databases[0] if databases else None
 
-    # [/DEF:get_database_by_uuid:Function]
+    # [/DEF:SupersetClientGetDatabaseByUuid:Function]
 
-    # [DEF:SupersetClient._resolve_target_id_for_delete:Function]
+    # [DEF:SupersetClientResolveTargetIdForDelete:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Resolves a dashboard ID from either an ID or a slug.
     # @PRE: Either dash_id or dash_slug should be provided.
     # @POST: Returns the resolved ID or None.
-    # @RELATION: [CALLS] ->[SupersetClient.get_dashboards]
+    # @RELATION: CALLS -> [SupersetClientGetDashboards]
     def _resolve_target_id_for_delete(
         self, dash_id: Optional[int], dash_slug: Optional[str]
     ) -> Optional[int]:
@@ -2074,14 +2076,14 @@ class SupersetClient:
                     )
             return None
 
-    # [/DEF:SupersetClient._resolve_target_id_for_delete:Function]
+    # [/DEF:SupersetClientResolveTargetIdForDelete:Function]
 
-    # [DEF:SupersetClient._do_import:Function]
+    # [DEF:SupersetClientDoImport:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Performs the actual multipart upload for import.
     # @PRE: file_name must be a path to an existing ZIP file.
     # @POST: Returns the API response from the upload.
-    # @RELATION: [CALLS] ->[APIClient.upload_file]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def _do_import(self, file_name: Union[str, Path]) -> Dict:
         with belief_scope("_do_import"):
             app_logger.debug(f"[_do_import][State] Uploading file: {file_name}")
@@ -2103,9 +2105,9 @@ class SupersetClient:
                 timeout=self.env.timeout * 2,
             )
 
-    # [/DEF:SupersetClient._do_import:Function]
+    # [/DEF:SupersetClientDoImport:Function]
 
-    # [DEF:_validate_export_response:Function]
+    # [DEF:SupersetClientValidateExportResponse:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Validates that the export response is a non-empty ZIP archive.
     # @PRE: response must be a valid requests.Response object.
@@ -2120,9 +2122,9 @@ class SupersetClient:
             if not response.content:
                 raise SupersetAPIError("Получены пустые данные при экспорте")
 
-    # [/DEF:_validate_export_response:Function]
+    # [/DEF:SupersetClientValidateExportResponse:Function]
 
-    # [DEF:_resolve_export_filename:Function]
+    # [DEF:SupersetClientResolveExportFilename:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Determines the filename for an exported dashboard.
     # @PRE: response must contain Content-Disposition header or dashboard_id must be provided.
@@ -2141,9 +2143,9 @@ class SupersetClient:
                 )
             return filename
 
-    # [/DEF:_resolve_export_filename:Function]
+    # [/DEF:SupersetClientResolveExportFilename:Function]
 
-    # [DEF:_validate_query_params:Function]
+    # [DEF:SupersetClientValidateQueryParams:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Ensures query parameters have default page and page_size.
     # @PRE: query can be None or a dictionary.
@@ -2155,14 +2157,14 @@ class SupersetClient:
             base_query = {"page": 0, "page_size": 100}
             return {**base_query, **(query or {})}
 
-    # [/DEF:_validate_query_params:Function]
+    # [/DEF:SupersetClientValidateQueryParams:Function]
 
-    # [DEF:_fetch_total_object_count:Function]
+    # [DEF:SupersetClientFetchTotalObjectCount:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Fetches the total number of items for a given endpoint.
     # @PRE: endpoint must be a valid Superset API path.
     # @POST: Returns the total count as an integer.
-    # @RELATION: [CALLS] ->[fetch_paginated_count]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def _fetch_total_object_count(self, endpoint: str) -> int:
         with belief_scope("_fetch_total_object_count"):
             return self.network.fetch_paginated_count(
@@ -2171,23 +2173,23 @@ class SupersetClient:
                 count_field="count",
             )
 
-    # [/DEF:_fetch_total_object_count:Function]
+    # [/DEF:SupersetClientFetchTotalObjectCount:Function]
 
-    # [DEF:_fetch_all_pages:Function]
+    # [DEF:SupersetClientFetchAllPages:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Iterates through all pages to collect all data items.
     # @PRE: pagination_options must contain base_query, total_count, and results_field.
     # @POST: Returns a combined list of all items.
-    # @RELATION: [CALLS] ->[fetch_paginated_data]
+    # @RELATION: CALLS -> [ConnectionContracts]
     def _fetch_all_pages(self, endpoint: str, pagination_options: Dict) -> List[Dict]:
         with belief_scope("_fetch_all_pages"):
             return self.network.fetch_paginated_data(
                 endpoint=endpoint, pagination_options=pagination_options
             )
 
-    # [/DEF:_fetch_all_pages:Function]
+    # [/DEF:SupersetClientFetchAllPages:Function]
 
-    # [DEF:_validate_import_file:Function]
+    # [DEF:SupersetClientValidateImportFile:Function]
     # @COMPLEXITY: 1
     # @PURPOSE: Validates that the file to be imported is a valid ZIP with metadata.yaml.
     # @PRE: zip_path must be a path to a file.
@@ -2205,16 +2207,16 @@ class SupersetClient:
                         f"Архив {zip_path} не содержит 'metadata.yaml'"
                     )
 
-    # [/DEF:_validate_import_file:Function]
+    # [/DEF:SupersetClientValidateImportFile:Function]
 
-    # [DEF:get_all_resources:Function]
+    # [DEF:SupersetClientGetAllResources:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Fetches all resources of a given type with id, uuid, and name columns.
     # @PARAM: resource_type (str) - One of "chart", "dataset", "dashboard".
     # @PRE: Client is authenticated. resource_type is valid.
     # @POST: Returns a list of resource dicts with at minimum id, uuid, and name fields.
     # @RETURN: List[Dict]
-    # @RELATION: [CALLS] ->[_fetch_all_pages]
+    # @RELATION: CALLS -> [SupersetClientFetchAllPages]
     def get_all_resources(
         self, resource_type: str, since_dttm: Optional[datetime] = None
     ) -> List[Dict]:
@@ -2268,7 +2270,7 @@ class SupersetClient:
             )
             return data
 
-    # [/DEF:get_all_resources:Function]
+    # [/DEF:SupersetClientGetAllResources:Function]
 
 
 # [/DEF:SupersetClient:Class]
diff --git a/backend/src/core/task_manager/__init__.py b/backend/src/core/task_manager/__init__.py
index da9dc452..b2bb5be8 100644
--- a/backend/src/core/task_manager/__init__.py
+++ b/backend/src/core/task_manager/__init__.py
@@ -5,7 +5,7 @@
 # @LAYER: Core
 # @RELATION: DEPENDS_ON ->[TaskManagerModels]
 # @RELATION: DEPENDS_ON ->[TaskManagerModule]
-# @RELATION: DEPENDS_ON ->[backend.src.core.task_manager.manager.TaskManager]
+# @RELATION: DEPENDS_ON ->[TaskManager]
 # @INVARIANT: Package exports stay aligned with manager and models contracts.
 
 from .models import Task, TaskStatus, LogEntry
@@ -13,4 +13,4 @@ from .manager import TaskManager
 
 __all__ = ["TaskManager", "Task", "TaskStatus", "LogEntry"]
 
-# [/DEF:TaskManagerPackage:Module]
\ No newline at end of file
+# [/DEF:TaskManagerPackage:Module]
diff --git a/backend/src/core/task_manager/context.py b/backend/src/core/task_manager/context.py
index 45f3104c..0c09be1c 100644
--- a/backend/src/core/task_manager/context.py
+++ b/backend/src/core/task_manager/context.py
@@ -3,7 +3,7 @@
 # @PURPOSE: Provides execution context passed to plugins during task execution.
 # @LAYER: Core
 # @RELATION: DEPENDS_ON -> [TaskLoggerModule]
-# @RELATION: USED_BY -> [TaskManager]
+# @RELATION: DEPENDS_ON -> [TaskManager]
 # @COMPLEXITY: 5
 # @INVARIANT: Each TaskContext is bound to a single task execution.
 # @PRE: Task execution pipeline provides valid task identifiers, logging callbacks, and parameter dictionaries.
@@ -31,7 +31,7 @@ from ..logger import belief_scope
 # @DATA_CONTRACT: Input[task_id, add_log_fn, params, default_source, background_tasks] -> Output[TaskContext]
 # @UX_STATE: Idle -> Active -> Complete
 #
-# @TEST_CONTRACT: TaskContextInit ->
+# @TEST_CONTRACT: TaskContextContract ->
 # {
 #   required_fields: {task_id: str, add_log_fn: Callable, params: dict},
 #   optional_fields: {default_source: str},
diff --git a/backend/src/core/task_manager/manager.py b/backend/src/core/task_manager/manager.py
index c4ebbc06..e475e0b4 100644
--- a/backend/src/core/task_manager/manager.py
+++ b/backend/src/core/task_manager/manager.py
@@ -1,4 +1,4 @@
-# [DEF:TaskManager:Module]
+# [DEF:TaskManagerModule:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: task, manager, lifecycle, execution, state
 # @PURPOSE: Manages the lifecycle of tasks, including their creation, execution, and state tracking. It uses a thread pool to run plugins asynchronously.
@@ -10,9 +10,13 @@
 # @RELATION: [DEPENDS_ON] ->[PluginLoader]
 # @RELATION: [DEPENDS_ON] ->[TaskPersistenceService]
 # @RELATION: [DEPENDS_ON] ->[TaskLogPersistenceService]
+# @RELATION: [DEPENDS_ON] ->[TaskContext]
+# @RELATION: [DEPENDS_ON] ->[TaskGraph]
+# @RELATION: [DEPENDS_ON] ->[JobLifecycle]
+# @RELATION: [DEPENDS_ON] ->[EventBus]
 # @INVARIANT: Task IDs are unique.
 # @CONSTRAINT: Must use belief_scope for logging.
-# @TEST_CONTRACT: TaskManagerModule -> {
+# @TEST_CONTRACT: TaskManagerRuntime -> {
 #    required_fields: {plugin_loader: PluginLoader},
 #    optional_fields: {},
 #    invariants: ["Must use belief_scope for logging"]
@@ -47,6 +51,12 @@ from ..logger import logger, belief_scope, should_log_task_level
 # @RELATION: [DEPENDS_ON] ->[TaskPersistenceService]
 # @RELATION: [DEPENDS_ON] ->[TaskLogPersistenceService]
 # @RELATION: [DEPENDS_ON] ->[PluginLoader]
+# @RELATION: [DEPENDS_ON] ->[TaskContext]
+# @RELATION: [DEPENDS_ON] ->[TaskGraph]
+# @RELATION: [DEPENDS_ON] ->[JobLifecycle]
+# @RELATION: [DEPENDS_ON] ->[EventBus]
+# @PRE: Plugin loader resolves plugin ids and persistence services are available for task state hydration.
+# @POST: In-memory task graph, lifecycle scheduler, and log event bus stay consistent with persisted task state.
 # @INVARIANT: Task IDs are unique within the registry.
 # @INVARIANT: Each task has exactly one status at any time.
 # @INVARIANT: Log entries are never deleted after being added to a task.
@@ -60,6 +70,44 @@ class TaskManager:
     # Log flush interval in seconds
     LOG_FLUSH_INTERVAL = 2.0
 
+    # [DEF:TaskGraph:Block]
+    # @COMPLEXITY: 5
+    # @PURPOSE: Represents the in-memory task dependency graph spanning task registry nodes, paused futures, and persistence-backed hydration.
+    # @RELATION: [DEPENDS_ON] ->[Task]
+    # @RELATION: [DEPENDS_ON] ->[TaskPersistenceService]
+    # @PRE: Task ids are generated before insertion and persisted tasks can be reconstructed into Task models.
+    # @POST: Each live task id resolves to at most one active Task node and optional pause future.
+    # @SIDE_EFFECT: Mutates the in-memory task registry and loads persisted state during manager startup.
+    # @DATA_CONTRACT: Input[Task lifecycle events] -> Output[tasks:Dict[str, Task], task_futures:Dict[str, asyncio.Future]]
+    # @INVARIANT: Registry membership is keyed by unique task id and survives log streaming side channels.
+    # [/DEF:TaskGraph:Block]
+
+    # [DEF:EventBus:Block]
+    # @COMPLEXITY: 5
+    # @PURPOSE: Coordinates task-scoped log buffering, persistence flushes, and subscriber fan-out for real-time observers.
+    # @RELATION: [DEPENDS_ON] ->[LogEntry]
+    # @RELATION: [DEPENDS_ON] ->[TaskLogPersistenceService]
+    # @PRE: Task log records accept structured LogEntry payloads and subscribers consume asyncio queues.
+    # @POST: Accepted task logs are buffered, optionally persisted, and dispatched to active subscribers in emission order.
+    # @SIDE_EFFECT: Writes task logs to persistence, mutates in-memory buffers, and pushes log entries into subscriber queues.
+    # @DATA_CONTRACT: Input[task_id, LogEntry, Queue subscribers] -> Output[persisted log rows, streamed log events]
+    # @INVARIANT: Buffered logs are retried on persistence failure and every subscriber receives only task-scoped events.
+    # [/DEF:EventBus:Block]
+
+    # [DEF:JobLifecycle:Block]
+    # @COMPLEXITY: 5
+    # @PURPOSE: Encodes task creation, execution, pause/resume, and completion transitions for plugin-backed jobs.
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
+    # @RELATION: [DEPENDS_ON] ->[TaskContext]
+    # @RELATION: [DEPENDS_ON] ->[PluginLoader]
+    # @PRE: Requested plugin ids resolve to executable plugins and task state transitions target known TaskStatus values.
+    # @POST: Every scheduled task transitions through a valid lifecycle path ending in persisted terminal or waiting state.
+    # @SIDE_EFFECT: Schedules async execution, pauses on input/mapping requests, and mutates persisted task lifecycle markers.
+    # @DATA_CONTRACT: Input[plugin_id, params, task_id, resolution payloads] -> Output[Task status transitions, task result]
+    # @INVARIANT: A task cannot be resumed from a waiting state unless a matching future exists or a new wait future is created.
+    # [/DEF:JobLifecycle:Block]
+
     # [DEF:__init__:Function]
     # @COMPLEXITY: 5
     # @PURPOSE: Initialize the TaskManager with dependencies.
@@ -67,9 +115,12 @@ class TaskManager:
     # @POST:    TaskManager is ready to accept tasks.
     # @SIDE_EFFECT: Starts background flusher thread and loads persisted task state into memory.
     # @RELATION: [CALLS] ->[TaskPersistenceService.load_tasks]
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     # @PARAM:   plugin_loader - The plugin loader instance.
     def __init__(self, plugin_loader):
         with belief_scope("TaskManager.__init__"):
+            logger.reason("Initializing task manager runtime services")
             self.plugin_loader = plugin_loader
             self.tasks: Dict[str, Task] = {}
             self.subscribers: Dict[str, List[asyncio.Queue]] = {}
@@ -98,6 +149,10 @@ class TaskManager:
 
             # Load persisted tasks on startup
             self.load_persisted_tasks()
+            logger.reflect(
+                "Task manager runtime initialized",
+                extra={"task_count": len(self.tasks)},
+            )
 
     # [/DEF:__init__:Function]
 
@@ -107,6 +162,7 @@ class TaskManager:
     # @PRE: TaskManager is initialized.
     # @POST: Logs are batch-written to database every LOG_FLUSH_INTERVAL seconds.
     # @RELATION: [CALLS] ->[TaskManager._flush_logs]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def _flusher_loop(self):
         """Background thread that flushes log buffer to database."""
         while not self._flusher_stop_event.is_set():
@@ -121,6 +177,7 @@ class TaskManager:
     # @PRE: None.
     # @POST: All buffered logs are written to task_logs table.
     # @RELATION: [CALLS] ->[TaskLogPersistenceService.add_logs]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def _flush_logs(self):
         """Flush all buffered logs to the database."""
         with self._log_buffer_lock:
@@ -151,6 +208,7 @@ class TaskManager:
     # @POST: Task's buffered logs are written to database.
     # @PARAM: task_id (str) - The task ID.
     # @RELATION: [CALLS] ->[TaskLogPersistenceService.add_logs]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def _flush_task_logs(self, task_id: str):
         """Flush logs for a specific task immediately."""
         with belief_scope("_flush_task_logs"):
@@ -176,6 +234,8 @@ class TaskManager:
     # @RETURN:  Task - The created task instance.
     # @THROWS:  ValueError if plugin not found or params invalid.
     # @RELATION: [CALLS] ->[TaskPersistenceService.persist_task]
+    # @RELATION: [DEPENDS_ON] ->[JobLifecycle]
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
     async def create_task(
         self, plugin_id: str, params: Dict[str, Any], user_id: Optional[str] = None
     ) -> Task:
@@ -190,6 +250,7 @@ class TaskManager:
                 logger.error("Task parameters must be a dictionary.")
                 raise ValueError("Task parameters must be a dictionary.")
 
+            logger.reason("Creating task node and scheduling execution")
             task = Task(plugin_id=plugin_id, params=params, user_id=user_id)
             self.tasks[task.id] = task
             self.persistence_service.persist_task(task)
@@ -197,6 +258,10 @@ class TaskManager:
             self.loop.create_task(
                 self._run_task(task.id)
             )  # Schedule task for execution
+            logger.reflect(
+                "Task creation persisted and execution scheduled",
+                extra={"task_id": task.id, "plugin_id": plugin_id},
+            )
             return task
 
     # [/DEF:create_task:Function]
@@ -208,11 +273,18 @@ class TaskManager:
     # @POST:    Task is executed, status updated to SUCCESS or FAILED.
     # @PARAM:   task_id (str) - The ID of the task to run.
     # @RELATION: [CALLS] ->[TaskPersistenceService.persist_task]
+    # @RELATION: [DEPENDS_ON] ->[JobLifecycle]
+    # @RELATION: [DEPENDS_ON] ->[TaskContext]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     async def _run_task(self, task_id: str):
         with belief_scope("TaskManager._run_task", f"task_id={task_id}"):
             task = self.tasks[task_id]
             plugin = self.plugin_loader.get_plugin(task.plugin_id)
 
+            logger.reason(
+                "Transitioning task to running state",
+                extra={"task_id": task_id, "plugin_id": task.plugin_id},
+            )
             logger.info(
                 f"Starting execution of task {task_id} for plugin '{plugin.name}'"
             )
@@ -286,6 +358,10 @@ class TaskManager:
                 logger.info(
                     f"Task {task_id} execution finished with status: {task.status}"
                 )
+                logger.reflect(
+                    "Task lifecycle reached persisted terminal state",
+                    extra={"task_id": task_id, "status": str(task.status)},
+                )
 
     # [/DEF:_run_task:Function]
 
@@ -298,6 +374,7 @@ class TaskManager:
     # @PARAM:   resolution_params (Dict[str, Any]) - Params to resolve the wait.
     # @THROWS:  ValueError if task not found or not awaiting mapping.
     # @RELATION: [CALLS] ->[TaskPersistenceService.persist_task]
+    # @RELATION: [DEPENDS_ON] ->[JobLifecycle]
     async def resolve_task(self, task_id: str, resolution_params: Dict[str, Any]):
         with belief_scope("TaskManager.resolve_task", f"task_id={task_id}"):
             task = self.tasks.get(task_id)
@@ -323,6 +400,7 @@ class TaskManager:
     # @POST:    Execution pauses until future is set.
     # @PARAM:   task_id (str) - The ID of the task.
     # @RELATION: [CALLS] ->[TaskPersistenceService.persist_task]
+    # @RELATION: [DEPENDS_ON] ->[JobLifecycle]
     async def wait_for_resolution(self, task_id: str):
         with belief_scope("TaskManager.wait_for_resolution", f"task_id={task_id}"):
             task = self.tasks.get(task_id)
@@ -347,7 +425,7 @@ class TaskManager:
     # @PRE:     Task exists.
     # @POST:    Execution pauses until future is set via resume_task_with_password.
     # @PARAM:   task_id (str) - The ID of the task.
-    # @RELATION: [CALLS] ->[asyncio.AbstractEventLoop.create_future]
+    # @RELATION: [DEPENDS_ON] ->[JobLifecycle]
     async def wait_for_input(self, task_id: str):
         with belief_scope("TaskManager.wait_for_input", f"task_id={task_id}"):
             task = self.tasks.get(task_id)
@@ -372,7 +450,7 @@ class TaskManager:
     # @POST:    Returns Task object or None.
     # @PARAM:   task_id (str) - ID of the task.
     # @RETURN:  Optional[Task] - The task or None.
-    # @RELATION: [READS] ->[TaskManager.tasks]
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
     def get_task(self, task_id: str) -> Optional[Task]:
         with belief_scope("TaskManager.get_task", f"task_id={task_id}"):
             return self.tasks.get(task_id)
@@ -385,7 +463,7 @@ class TaskManager:
     # @PRE:     None.
     # @POST:    Returns list of all Task objects.
     # @RETURN:  List[Task] - All tasks.
-    # @RELATION: [READS] ->[TaskManager.tasks]
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
     def get_all_tasks(self) -> List[Task]:
         with belief_scope("TaskManager.get_all_tasks"):
             return list(self.tasks.values())
@@ -401,7 +479,7 @@ class TaskManager:
     # @PARAM:   offset (int) - Number of tasks to skip.
     # @PARAM:   status (Optional[TaskStatus]) - Filter by task status.
     # @RETURN:  List[Task] - List of tasks matching criteria.
-    # @RELATION: [READS] ->[TaskManager.tasks]
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
     def get_tasks(
         self,
         limit: int = 10,
@@ -447,6 +525,7 @@ class TaskManager:
     # @PARAM:   log_filter (Optional[LogFilter]) - Filter parameters.
     # @RETURN:  List[LogEntry] - List of log entries.
     # @RELATION: [CALLS] ->[TaskLogPersistenceService.get_logs]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def get_task_logs(
         self, task_id: str, log_filter: Optional[LogFilter] = None
     ) -> List[LogEntry]:
@@ -483,6 +562,7 @@ class TaskManager:
     # @PARAM: task_id (str) - The task ID.
     # @RETURN: LogStats - Statistics about task logs.
     # @RELATION: [CALLS] ->[TaskLogPersistenceService.get_log_stats]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def get_task_log_stats(self, task_id: str) -> LogStats:
         with belief_scope("TaskManager.get_task_log_stats", f"task_id={task_id}"):
             return self.log_persistence_service.get_log_stats(task_id)
@@ -497,6 +577,7 @@ class TaskManager:
     # @PARAM: task_id (str) - The task ID.
     # @RETURN: List[str] - Unique source names.
     # @RELATION: [CALLS] ->[TaskLogPersistenceService.get_sources]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def get_task_log_sources(self, task_id: str) -> List[str]:
         with belief_scope("TaskManager.get_task_log_sources", f"task_id={task_id}"):
             return self.log_persistence_service.get_sources(task_id)
@@ -515,6 +596,7 @@ class TaskManager:
     # @PARAM:   metadata (Optional[Dict]) - Additional structured data.
     # @PARAM:   context (Optional[Dict]) - Legacy context (for backward compatibility).
     # @RELATION: [CALLS] ->[should_log_task_level]
+    # @RELATION: [DISPATCHES] ->[EventBus]
     def _add_log(
         self,
         task_id: str,
@@ -565,7 +647,7 @@ class TaskManager:
     # @POST:    Returns an asyncio.Queue for log entries.
     # @PARAM:   task_id (str) - ID of the task.
     # @RETURN:  asyncio.Queue - Queue for log entries.
-    # @RELATION: [MUTATES] ->[TaskManager.subscribers]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     async def subscribe_logs(self, task_id: str) -> asyncio.Queue:
         with belief_scope("TaskManager.subscribe_logs", f"task_id={task_id}"):
             queue = asyncio.Queue()
@@ -583,7 +665,7 @@ class TaskManager:
     # @POST:    Queue removed from subscribers.
     # @PARAM:   task_id (str) - ID of the task.
     # @PARAM:   queue (asyncio.Queue) - Queue to remove.
-    # @RELATION: [MUTATES] ->[TaskManager.subscribers]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def unsubscribe_logs(self, task_id: str, queue: asyncio.Queue):
         with belief_scope("TaskManager.unsubscribe_logs", f"task_id={task_id}"):
             if task_id in self.subscribers:
@@ -600,6 +682,7 @@ class TaskManager:
     # @PRE:     None.
     # @POST:    Persisted tasks loaded into self.tasks.
     # @RELATION: [CALLS] ->[TaskPersistenceService.load_tasks]
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
     def load_persisted_tasks(self) -> None:
         with belief_scope("TaskManager.load_persisted_tasks"):
             loaded_tasks = self.persistence_service.load_tasks(limit=100)
@@ -618,6 +701,7 @@ class TaskManager:
     # @PARAM:   input_request (Dict) - Details about required input.
     # @THROWS:  ValueError if task not found or not RUNNING.
     # @RELATION: [CALLS] ->[TaskPersistenceService.persist_task]
+    # @RELATION: [DEPENDS_ON] ->[JobLifecycle]
     def await_input(self, task_id: str, input_request: Dict[str, Any]) -> None:
         with belief_scope("TaskManager.await_input", f"task_id={task_id}"):
             task = self.tasks.get(task_id)
@@ -636,7 +720,7 @@ class TaskManager:
                 task_id,
                 "INFO",
                 "Task paused for user input",
-                {"input_request": input_request},
+                metadata={"input_request": input_request},
             )
 
     # [/DEF:await_input:Function]
@@ -650,6 +734,7 @@ class TaskManager:
     # @PARAM:   passwords (Dict[str, str]) - Mapping of database name to password.
     # @THROWS:  ValueError if task not found, not awaiting input, or passwords invalid.
     # @RELATION: [CALLS] ->[TaskPersistenceService.persist_task]
+    # @RELATION: [DEPENDS_ON] ->[JobLifecycle]
     def resume_task_with_password(
         self, task_id: str, passwords: Dict[str, str]
     ) -> None:
@@ -676,7 +761,7 @@ class TaskManager:
                 task_id,
                 "INFO",
                 "Task resumed with passwords",
-                {"databases": list(passwords.keys())},
+                metadata={"databases": list(passwords.keys())},
             )
 
             if task_id in self.task_futures:
@@ -692,6 +777,8 @@ class TaskManager:
     # @PARAM:   status (Optional[TaskStatus]) - Filter by task status.
     # @RETURN:  int - Number of tasks cleared.
     # @RELATION: [CALLS] ->[TaskPersistenceService.delete_tasks]
+    # @RELATION: [DEPENDS_ON] ->[TaskGraph]
+    # @RELATION: [DEPENDS_ON] ->[EventBus]
     def clear_tasks(self, status: Optional[TaskStatus] = None) -> int:
         with belief_scope("TaskManager.clear_tasks"):
             tasks_to_remove = []
@@ -739,4 +826,4 @@ class TaskManager:
 
 
 # [/DEF:TaskManager:Class]
-# [/DEF:TaskManager:Module]
+# [/DEF:TaskManagerModule:Module]
diff --git a/backend/src/core/task_manager/models.py b/backend/src/core/task_manager/models.py
index 1c756b88..e17dcaa7 100644
--- a/backend/src/core/task_manager/models.py
+++ b/backend/src/core/task_manager/models.py
@@ -4,7 +4,7 @@
 # @PURPOSE: Defines the data models and enumerations used by the Task Manager.
 # @LAYER: Core
 # @RELATION: [USED_BY] -> [TaskManager]
-# @RELATION: [USED_BY] -> [ApiRoutes]
+# @RELATION: [USED_BY] -> [TaskManagerPackage]
 # @INVARIANT: Task IDs are immutable once created.
 # @CONSTRAINT: Must use Pydantic for data validation.
 
@@ -38,7 +38,7 @@ class TaskStatus(str, Enum):
 # @SEMANTICS: log, level, severity, enum
 # @PURPOSE: Defines the possible log levels for task logging.
 # @COMPLEXITY: 1
-# @RELATION: [USED_BY] -> [LogEntry]
+# @RELATION: [DEPENDS_ON] -> [LogEntry]
 # @RELATION: [USED_BY] -> [TaskLogger]
 class LogLevel(str, Enum):
     DEBUG = "DEBUG"
@@ -55,7 +55,7 @@ class LogLevel(str, Enum):
 # @PURPOSE: A Pydantic model representing a single, structured log entry associated with a task.
 # @COMPLEXITY: 2
 # @RELATION: [DEPENDS_ON] -> [LogLevel]
-# @RELATION: [PART_OF] -> [Task]
+# @RELATION: [DEPENDS_ON] -> [Task]
 # @INVARIANT: Each log entry has a unique timestamp and source.
 #
 # @TEST_CONTRACT: LogEntryModel ->
@@ -87,7 +87,7 @@ class LogEntry(BaseModel):
 # @SEMANTICS: task, log, persistent, pydantic
 # @PURPOSE: A Pydantic model representing a persisted log entry from the database.
 # @COMPLEXITY: 3
-# @RELATION: [MAPS_TO] -> [TaskLogRecord]
+# @RELATION: [DEPENDS_ON] -> [TaskLogRecord]
 class TaskLog(BaseModel):
     id: int
     task_id: str
@@ -108,7 +108,7 @@ class TaskLog(BaseModel):
 # @SEMANTICS: log, filter, query, pydantic
 # @PURPOSE: Filter parameters for querying task logs.
 # @COMPLEXITY: 1
-# @RELATION: [USED_BY] -> [TaskManager]
+# @RELATION: [DEPENDS_ON] -> [TaskManager]
 class LogFilter(BaseModel):
     level: Optional[str] = None  # Filter by log level
     source: Optional[str] = None  # Filter by source component
@@ -124,7 +124,7 @@ class LogFilter(BaseModel):
 # @SEMANTICS: log, stats, aggregation, pydantic
 # @PURPOSE: Statistics about log entries for a task.
 # @COMPLEXITY: 1
-# @RELATION: [COMPUTED_FROM] -> [TaskLog]
+# @RELATION: [DEPENDS_ON] -> [TaskLog]
 class LogStats(BaseModel):
     total_count: int
     by_level: Dict[str, int]  # {"INFO": 10, "ERROR": 2}
@@ -139,8 +139,8 @@ class LogStats(BaseModel):
 # @SEMANTICS: task, job, execution, state, pydantic
 # @PURPOSE: A Pydantic model representing a single execution instance of a plugin, including its status, parameters, and logs.
 # @RELATION: [DEPENDS_ON] -> [TaskStatus]
-# @RELATION: [CONTAINS] -> [LogEntry]
-# @RELATION: [USED_BY] -> [TaskManager]
+# @RELATION: [DEPENDS_ON] -> [LogEntry]
+# @RELATION: [DEPENDS_ON] -> [TaskManager]
 class Task(BaseModel):
     id: str = Field(default_factory=lambda: str(uuid.uuid4()))
     plugin_id: str
diff --git a/backend/src/core/task_manager/persistence.py b/backend/src/core/task_manager/persistence.py
index afc737ed..bb32c271 100644
--- a/backend/src/core/task_manager/persistence.py
+++ b/backend/src/core/task_manager/persistence.py
@@ -7,7 +7,8 @@
 # @POST: Provides reliable storage and retrieval for task metadata and logs.
 # @SIDE_EFFECT: Performs database I/O on tasks.db.
 # @DATA_CONTRACT: Input[Task, LogEntry] -> Model[TaskRecord, TaskLogRecord]
-# @RELATION: [USED_BY] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[TaskGraph]
 # @RELATION: [DEPENDS_ON] ->[TasksSessionLocal]
 # @INVARIANT: Database schema must match the TaskRecord model structure.
 
@@ -25,6 +26,7 @@ from .models import Task, TaskStatus, LogEntry, TaskLog, LogFilter, LogStats
 from ..logger import logger, belief_scope
 # [/SECTION]
 
+
 # [DEF:TaskPersistenceService:Class]
 # @COMPLEXITY: 5
 # @SEMANTICS: persistence, service, database, sqlalchemy
@@ -36,10 +38,11 @@ from ..logger import logger, belief_scope
 # @RELATION: [DEPENDS_ON] ->[TasksSessionLocal]
 # @RELATION: [DEPENDS_ON] ->[TaskRecord]
 # @RELATION: [DEPENDS_ON] ->[Environment]
-# @RELATION: [USED_BY] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[TaskGraph]
 # @INVARIANT: Persistence must handle potentially missing task fields natively.
 #
-# @TEST_CONTRACT: TaskPersistenceService ->
+# @TEST_CONTRACT: TaskPersistenceContract ->
 # {
 #   required_fields: {},
 #   invariants: [
@@ -74,6 +77,7 @@ class TaskPersistenceService:
                 except json.JSONDecodeError:
                     return value
             return value
+
     # [/DEF:_json_load_if_needed:Function]
 
     # [DEF:_parse_datetime:Function]
@@ -92,6 +96,7 @@ class TaskPersistenceService:
                 except ValueError:
                     return None
             return None
+
     # [/DEF:_parse_datetime:Function]
 
     # [DEF:_resolve_environment_id:Function]
@@ -102,19 +107,25 @@ class TaskPersistenceService:
     # @DATA_CONTRACT: Input[env_id: Optional[str]] -> Output[Optional[str]]
     # @RELATION: [DEPENDS_ON] ->[Environment]
     @staticmethod
-    def _resolve_environment_id(session: Session, env_id: Optional[str]) -> Optional[str]:
+    def _resolve_environment_id(
+        session: Session, env_id: Optional[str]
+    ) -> Optional[str]:
         with belief_scope("_resolve_environment_id"):
             raw_value = str(env_id or "").strip()
             if not raw_value:
                 return None
 
             # 1) Direct match by primary key.
-            by_id = session.query(Environment).filter(Environment.id == raw_value).first()
+            by_id = (
+                session.query(Environment).filter(Environment.id == raw_value).first()
+            )
             if by_id:
                 return str(by_id.id)
 
             # 2) Exact match by name.
-            by_name = session.query(Environment).filter(Environment.name == raw_value).first()
+            by_name = (
+                session.query(Environment).filter(Environment.name == raw_value).first()
+            )
             if by_name:
                 return str(by_name.id)
 
@@ -128,10 +139,14 @@ class TaskPersistenceService:
                 return None
 
             for env in session.query(Environment).all():
-                if normalize_token(env.id) == target_token or normalize_token(env.name) == target_token:
+                if (
+                    normalize_token(env.id) == target_token
+                    or normalize_token(env.name) == target_token
+                ):
                     return str(env.id)
 
             return None
+
     # [/DEF:_resolve_environment_id:Function]
 
     # [DEF:__init__:Function]
@@ -143,6 +158,7 @@ class TaskPersistenceService:
         with belief_scope("TaskPersistenceService.__init__"):
             # We use TasksSessionLocal from database.py
             pass
+
     # [/DEF:__init__:Function]
 
     # [DEF:persist_task:Function]
@@ -158,18 +174,24 @@ class TaskPersistenceService:
         with belief_scope("TaskPersistenceService.persist_task", f"task_id={task.id}"):
             session: Session = TasksSessionLocal()
             try:
-                record = session.query(TaskRecord).filter(TaskRecord.id == task.id).first()
+                record = (
+                    session.query(TaskRecord).filter(TaskRecord.id == task.id).first()
+                )
                 if not record:
                     record = TaskRecord(id=task.id)
                     session.add(record)
-                
+
                 record.type = task.plugin_id
                 record.status = task.status.value
-                raw_env_id = task.params.get("environment_id") or task.params.get("source_env_id")
-                record.environment_id = self._resolve_environment_id(session, raw_env_id)
+                raw_env_id = task.params.get("environment_id") or task.params.get(
+                    "source_env_id"
+                )
+                record.environment_id = self._resolve_environment_id(
+                    session, raw_env_id
+                )
                 record.started_at = task.started_at
                 record.finished_at = task.finished_at
-                
+
                 # Ensure params and result are JSON serializable
                 def json_serializable(obj):
                     with belief_scope("TaskPersistenceService.json_serializable"):
@@ -183,31 +205,32 @@ class TaskPersistenceService:
 
                 record.params = json_serializable(task.params)
                 record.result = json_serializable(task.result)
-                
+
                 # Store logs as JSON, converting datetime to string
                 record.logs = []
                 for log in task.logs:
                     log_dict = log.dict()
-                    if isinstance(log_dict.get('timestamp'), datetime):
-                        log_dict['timestamp'] = log_dict['timestamp'].isoformat()
+                    if isinstance(log_dict.get("timestamp"), datetime):
+                        log_dict["timestamp"] = log_dict["timestamp"].isoformat()
                     # Also clean up any datetimes in context
-                    if log_dict.get('context'):
-                        log_dict['context'] = json_serializable(log_dict['context'])
+                    if log_dict.get("context"):
+                        log_dict["context"] = json_serializable(log_dict["context"])
                     record.logs.append(log_dict)
-                
+
                 # Extract error if failed
                 if task.status == TaskStatus.FAILED:
                     for log in reversed(task.logs):
                         if log.level == "ERROR":
                             record.error = log.message
                             break
-                
+
                 session.commit()
             except Exception as e:
                 session.rollback()
                 logger.error(f"Failed to persist task {task.id}: {e}")
             finally:
                 session.close()
+
     # [/DEF:persist_task:Function]
 
     # [DEF:persist_tasks:Function]
@@ -221,6 +244,7 @@ class TaskPersistenceService:
         with belief_scope("TaskPersistenceService.persist_tasks"):
             for task in tasks:
                 self.persist_task(task)
+
     # [/DEF:persist_tasks:Function]
 
     # [DEF:load_tasks:Function]
@@ -234,16 +258,20 @@ class TaskPersistenceService:
     # @DATA_CONTRACT: Model[TaskRecord] -> Output[List[Task]]
     # @RELATION: [CALLS] ->[_json_load_if_needed]
     # @RELATION: [CALLS] ->[_parse_datetime]
-    def load_tasks(self, limit: int = 100, status: Optional[TaskStatus] = None) -> List[Task]:
+    def load_tasks(
+        self, limit: int = 100, status: Optional[TaskStatus] = None
+    ) -> List[Task]:
         with belief_scope("TaskPersistenceService.load_tasks"):
             session: Session = TasksSessionLocal()
             try:
                 query = session.query(TaskRecord)
                 if status:
                     query = query.filter(TaskRecord.status == status.value)
-                
-                records = query.order_by(TaskRecord.created_at.desc()).limit(limit).all()
-                
+
+                records = (
+                    query.order_by(TaskRecord.created_at.desc()).limit(limit).all()
+                )
+
                 loaded_tasks = []
                 for record in records:
                     try:
@@ -254,7 +282,10 @@ class TaskPersistenceService:
                                 if not isinstance(log_data, dict):
                                     continue
                                 log_data = dict(log_data)
-                                log_data['timestamp'] = self._parse_datetime(log_data.get('timestamp')) or datetime.utcnow()
+                                log_data["timestamp"] = (
+                                    self._parse_datetime(log_data.get("timestamp"))
+                                    or datetime.utcnow()
+                                )
                                 logs.append(LogEntry(**log_data))
 
                         started_at = self._parse_datetime(record.started_at)
@@ -270,15 +301,16 @@ class TaskPersistenceService:
                             finished_at=finished_at,
                             params=params if isinstance(params, dict) else {},
                             result=result,
-                            logs=logs
+                            logs=logs,
                         )
                         loaded_tasks.append(task)
                     except Exception as e:
                         logger.error(f"Failed to reconstruct task {record.id}: {e}")
-                
+
                 return loaded_tasks
             finally:
                 session.close()
+
     # [/DEF:load_tasks:Function]
 
     # [DEF:delete_tasks:Function]
@@ -295,16 +327,22 @@ class TaskPersistenceService:
         with belief_scope("TaskPersistenceService.delete_tasks"):
             session: Session = TasksSessionLocal()
             try:
-                session.query(TaskRecord).filter(TaskRecord.id.in_(task_ids)).delete(synchronize_session=False)
+                session.query(TaskRecord).filter(TaskRecord.id.in_(task_ids)).delete(
+                    synchronize_session=False
+                )
                 session.commit()
             except Exception as e:
                 session.rollback()
                 logger.error(f"Failed to delete tasks: {e}")
             finally:
                 session.close()
+
     # [/DEF:delete_tasks:Function]
+
+
 # [/DEF:TaskPersistenceService:Class]
 
+
 # [DEF:TaskLogPersistenceService:Class]
 # @COMPLEXITY: 5
 # @SEMANTICS: persistence, service, database, log, sqlalchemy
@@ -315,10 +353,11 @@ class TaskPersistenceService:
 # @DATA_CONTRACT: Input[task_id:str, logs:List[LogEntry], log_filter:LogFilter, task_ids:List[str]] -> Model[TaskLogRecord] -> Output[None | List[TaskLog] | LogStats | List[str]]
 # @RELATION: [DEPENDS_ON] ->[TaskLogRecord]
 # @RELATION: [DEPENDS_ON] ->[TasksSessionLocal]
-# @RELATION: [USED_BY] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[EventBus]
 # @INVARIANT: Log entries are batch-inserted for performance.
 #
-# @TEST_CONTRACT: TaskLogPersistenceService ->
+# @TEST_CONTRACT: TaskLogPersistenceContract ->
 # {
 #   required_fields: {},
 #   invariants: [
@@ -335,7 +374,7 @@ class TaskLogPersistenceService:
     Service for persisting and querying task logs.
     Supports batch inserts, filtering, and statistics.
     """
-    
+
     # [DEF:__init__:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Initializes the TaskLogPersistenceService
@@ -343,8 +382,9 @@ class TaskLogPersistenceService:
     # @POST: Service is ready for log persistence
     def __init__(self, config=None):
         pass
+
     # [/DEF:__init__:Function]
-    
+
     # [DEF:add_logs:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Batch insert log entries for a task.
@@ -368,7 +408,9 @@ class TaskLogPersistenceService:
                         level=log.level,
                         source=log.source or "system",
                         message=log.message,
-                        metadata_json=json.dumps(log.metadata) if log.metadata else None
+                        metadata_json=json.dumps(log.metadata)
+                        if log.metadata
+                        else None,
                     )
                     session.add(record)
                 session.commit()
@@ -377,8 +419,9 @@ class TaskLogPersistenceService:
                 logger.error(f"Failed to add logs for task {task_id}: {e}")
             finally:
                 session.close()
+
     # [/DEF:add_logs:Function]
-    
+
     # [DEF:get_logs:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Query logs for a task with filtering and pagination.
@@ -395,23 +438,27 @@ class TaskLogPersistenceService:
         with belief_scope("TaskLogPersistenceService.get_logs", f"task_id={task_id}"):
             session: Session = TasksSessionLocal()
             try:
-                query = session.query(TaskLogRecord).filter(TaskLogRecord.task_id == task_id)
-                
+                query = session.query(TaskLogRecord).filter(
+                    TaskLogRecord.task_id == task_id
+                )
+
                 # Apply filters
                 if log_filter.level:
-                    query = query.filter(TaskLogRecord.level == log_filter.level.upper())
+                    query = query.filter(
+                        TaskLogRecord.level == log_filter.level.upper()
+                    )
                 if log_filter.source:
                     query = query.filter(TaskLogRecord.source == log_filter.source)
                 if log_filter.search:
                     search_pattern = f"%{log_filter.search}%"
                     query = query.filter(TaskLogRecord.message.ilike(search_pattern))
-                
+
                 # Order by timestamp ascending (oldest first)
                 query = query.order_by(TaskLogRecord.timestamp.asc())
-                
+
                 # Apply pagination
                 records = query.offset(log_filter.offset).limit(log_filter.limit).all()
-                
+
                 logs = []
                 for record in records:
                     metadata = None
@@ -420,22 +467,25 @@ class TaskLogPersistenceService:
                             metadata = json.loads(record.metadata_json)
                         except json.JSONDecodeError:
                             metadata = None
-                    
-                    logs.append(TaskLog(
-                        id=record.id,
-                        task_id=record.task_id,
-                        timestamp=record.timestamp,
-                        level=record.level,
-                        source=record.source,
-                        message=record.message,
-                        metadata=metadata
-                    ))
-                
+
+                    logs.append(
+                        TaskLog(
+                            id=record.id,
+                            task_id=record.task_id,
+                            timestamp=record.timestamp,
+                            level=record.level,
+                            source=record.source,
+                            message=record.message,
+                            metadata=metadata,
+                        )
+                    )
+
                 return logs
             finally:
                 session.close()
+
     # [/DEF:get_logs:Function]
-    
+
     # [DEF:get_log_stats:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Get statistics about logs for a task.
@@ -447,44 +497,48 @@ class TaskLogPersistenceService:
     # @RELATION: [DEPENDS_ON] ->[TaskLogRecord]
     # @RELATION: [DEPENDS_ON] ->[LogStats]
     def get_log_stats(self, task_id: str) -> LogStats:
-        with belief_scope("TaskLogPersistenceService.get_log_stats", f"task_id={task_id}"):
+        with belief_scope(
+            "TaskLogPersistenceService.get_log_stats", f"task_id={task_id}"
+        ):
             session: Session = TasksSessionLocal()
             try:
                 # Get total count
-                total_count = session.query(TaskLogRecord).filter(
-                    TaskLogRecord.task_id == task_id
-                ).count()
-                
+                total_count = (
+                    session.query(TaskLogRecord)
+                    .filter(TaskLogRecord.task_id == task_id)
+                    .count()
+                )
+
                 # Get counts by level
                 from sqlalchemy import func
-                level_counts = session.query(
-                    TaskLogRecord.level,
-                    func.count(TaskLogRecord.id)
-                ).filter(
-                    TaskLogRecord.task_id == task_id
-                ).group_by(TaskLogRecord.level).all()
-                
+
+                level_counts = (
+                    session.query(TaskLogRecord.level, func.count(TaskLogRecord.id))
+                    .filter(TaskLogRecord.task_id == task_id)
+                    .group_by(TaskLogRecord.level)
+                    .all()
+                )
+
                 by_level = {level: count for level, count in level_counts}
-                
+
                 # Get counts by source
-                source_counts = session.query(
-                    TaskLogRecord.source,
-                    func.count(TaskLogRecord.id)
-                ).filter(
-                    TaskLogRecord.task_id == task_id
-                ).group_by(TaskLogRecord.source).all()
-                
+                source_counts = (
+                    session.query(TaskLogRecord.source, func.count(TaskLogRecord.id))
+                    .filter(TaskLogRecord.task_id == task_id)
+                    .group_by(TaskLogRecord.source)
+                    .all()
+                )
+
                 by_source = {source: count for source, count in source_counts}
-                
+
                 return LogStats(
-                    total_count=total_count,
-                    by_level=by_level,
-                    by_source=by_source
+                    total_count=total_count, by_level=by_level, by_source=by_source
                 )
             finally:
                 session.close()
+
     # [/DEF:get_log_stats:Function]
-    
+
     # [DEF:get_sources:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Get unique sources for a task's logs.
@@ -495,18 +549,24 @@ class TaskLogPersistenceService:
     # @DATA_CONTRACT: Model[TaskLogRecord] -> Output[List[str]]
     # @RELATION: [DEPENDS_ON] ->[TaskLogRecord]
     def get_sources(self, task_id: str) -> List[str]:
-        with belief_scope("TaskLogPersistenceService.get_sources", f"task_id={task_id}"):
+        with belief_scope(
+            "TaskLogPersistenceService.get_sources", f"task_id={task_id}"
+        ):
             session: Session = TasksSessionLocal()
             try:
                 from sqlalchemy import distinct
-                sources = session.query(distinct(TaskLogRecord.source)).filter(
-                    TaskLogRecord.task_id == task_id
-                ).all()
+
+                sources = (
+                    session.query(distinct(TaskLogRecord.source))
+                    .filter(TaskLogRecord.task_id == task_id)
+                    .all()
+                )
                 return [s[0] for s in sources]
             finally:
                 session.close()
+
     # [/DEF:get_sources:Function]
-    
+
     # [DEF:delete_logs_for_task:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Delete all logs for a specific task.
@@ -516,7 +576,9 @@ class TaskLogPersistenceService:
     # @SIDE_EFFECT: Deletes from task_logs table.
     # @RELATION: [DEPENDS_ON] ->[TaskLogRecord]
     def delete_logs_for_task(self, task_id: str) -> None:
-        with belief_scope("TaskLogPersistenceService.delete_logs_for_task", f"task_id={task_id}"):
+        with belief_scope(
+            "TaskLogPersistenceService.delete_logs_for_task", f"task_id={task_id}"
+        ):
             session: Session = TasksSessionLocal()
             try:
                 session.query(TaskLogRecord).filter(
@@ -528,8 +590,9 @@ class TaskLogPersistenceService:
                 logger.error(f"Failed to delete logs for task {task_id}: {e}")
             finally:
                 session.close()
+
     # [/DEF:delete_logs_for_task:Function]
-    
+
     # [DEF:delete_logs_for_tasks:Function]
     # @COMPLEXITY: 3
     # @PURPOSE: Delete all logs for multiple tasks.
@@ -553,6 +616,9 @@ class TaskLogPersistenceService:
                 logger.error(f"Failed to delete logs for tasks: {e}")
             finally:
                 session.close()
+
     # [/DEF:delete_logs_for_tasks:Function]
+
+
 # [/DEF:TaskLogPersistenceService:Class]
 # [/DEF:TaskPersistenceModule:Module]
diff --git a/backend/src/core/task_manager/task_logger.py b/backend/src/core/task_manager/task_logger.py
index ca3f7c80..62c59959 100644
--- a/backend/src/core/task_manager/task_logger.py
+++ b/backend/src/core/task_manager/task_logger.py
@@ -3,7 +3,7 @@
 # @PURPOSE: Provides a dedicated logger for tasks with automatic source attribution.
 # @LAYER: Core
 # @RELATION: [DEPENDS_ON] -> [TaskManager]
-# @RELATION: [CALLS] -> [_add_log]
+# @RELATION: [DEPENDS_ON] -> [EventBus]
 # @COMPLEXITY: 2
 # @INVARIANT: Each TaskLogger instance is bound to a specific task_id and default source.
 
@@ -17,12 +17,12 @@ from typing import Dict, Any, Optional, Callable
 # @PURPOSE: A wrapper around TaskManager._add_log that carries task_id and source context.
 # @COMPLEXITY: 2
 # @RELATION: [DEPENDS_ON] -> [TaskManager]
-# @RELATION: [CALLS] -> [_add_log]
-# @RELATION: [USED_BY] -> [TaskManager]
+# @RELATION: [DEPENDS_ON] -> [EventBus]
+# @RELATION: [USED_BY] -> [TaskContext]
 # @INVARIANT: All log calls include the task_id and source.
 # @UX_STATE: Idle -> Logging -> (system records log)
 #
-# @TEST_CONTRACT: TaskLoggerModel ->
+# @TEST_CONTRACT: TaskLoggerContract ->
 # {
 #   required_fields: {task_id: str, add_log_fn: Callable},
 #   optional_fields: {source: str},
diff --git a/backend/src/models/__tests__/test_clean_release.py b/backend/src/models/__tests__/test_clean_release.py
index 13b7b815..14e6e8d0 100644
--- a/backend/src/models/__tests__/test_clean_release.py
+++ b/backend/src/models/__tests__/test_clean_release.py
@@ -1,16 +1,16 @@
-# [DEF:__tests__/test_clean_release:Module]
-# @RELATION: VERIFIES -> ../clean_release.py
+# [DEF:TestCleanReleaseModels:Module]
+# @RELATION: VERIFIES -> [CleanReleaseModels]
 # @PURPOSE: Contract testing for Clean Release models
-# [/DEF:__tests__/test_clean_release:Module]
+# [/DEF:TestCleanReleaseModels:Module]
 
 import pytest
 from datetime import datetime
 from pydantic import ValidationError
 from src.models.clean_release import (
-    ReleaseCandidate, 
-    ReleaseCandidateStatus, 
-    ProfileType, 
-    CleanProfilePolicy, 
+    ReleaseCandidate,
+    ReleaseCandidateStatus,
+    ProfileType,
+    CleanProfilePolicy,
     DistributionManifest,
     ManifestItem,
     ManifestSummary,
@@ -21,9 +21,10 @@ from src.models.clean_release import (
     CheckStageName,
     CheckStageStatus,
     ComplianceReport,
-    ExecutionMode
+    ExecutionMode,
 )
 
+
 # @TEST_FIXTURE: valid_enterprise_candidate
 @pytest.fixture
 def valid_candidate_data():
@@ -33,30 +34,35 @@ def valid_candidate_data():
         "profile": ProfileType.ENTERPRISE_CLEAN,
         "created_at": datetime.now(),
         "created_by": "admin",
-        "source_snapshot_ref": "v1.0.0-snapshot"
+        "source_snapshot_ref": "v1.0.0-snapshot",
     }
 
+
 # [DEF:test_release_candidate_valid:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify that a valid release candidate can be instantiated.
 def test_release_candidate_valid(valid_candidate_data):
     rc = ReleaseCandidate(**valid_candidate_data)
     assert rc.candidate_id == "RC-001"
     assert rc.status == ReleaseCandidateStatus.DRAFT
 
+
 # [/DEF:test_release_candidate_valid:Function]
 
+
 # [DEF:test_release_candidate_empty_id:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify that a release candidate with an empty ID is rejected.
 def test_release_candidate_empty_id(valid_candidate_data):
     valid_candidate_data["candidate_id"] = "  "
     with pytest.raises(ValueError, match="candidate_id must be non-empty"):
         ReleaseCandidate(**valid_candidate_data)
 
+
 # @TEST_FIXTURE: valid_enterprise_policy
 # [/DEF:test_release_candidate_empty_id:Function]
 
+
 @pytest.fixture
 def valid_policy_data():
     return {
@@ -67,72 +73,103 @@ def valid_policy_data():
         "required_system_categories": ["core"],
         "internal_source_registry_ref": "REG-1",
         "effective_from": datetime.now(),
-        "profile": ProfileType.ENTERPRISE_CLEAN
+        "profile": ProfileType.ENTERPRISE_CLEAN,
     }
 
+
 # @TEST_INVARIANT: policy_purity
 # [DEF:test_enterprise_policy_valid:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify that a valid enterprise policy is accepted.
 def test_enterprise_policy_valid(valid_policy_data):
     policy = CleanProfilePolicy(**valid_policy_data)
     assert policy.external_source_forbidden is True
 
+
 # @TEST_EDGE: enterprise_policy_missing_prohibited
 # [/DEF:test_enterprise_policy_valid:Function]
 
+
 # [DEF:test_enterprise_policy_missing_prohibited:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify that an enterprise policy without prohibited categories is rejected.
 def test_enterprise_policy_missing_prohibited(valid_policy_data):
     valid_policy_data["prohibited_artifact_categories"] = []
-    with pytest.raises(ValueError, match="enterprise-clean policy requires prohibited_artifact_categories"):
+    with pytest.raises(
+        ValueError,
+        match="enterprise-clean policy requires prohibited_artifact_categories",
+    ):
         CleanProfilePolicy(**valid_policy_data)
 
+
 # @TEST_EDGE: enterprise_policy_external_allowed
 # [/DEF:test_enterprise_policy_missing_prohibited:Function]
 
+
 # [DEF:test_enterprise_policy_external_allowed:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify that an enterprise policy allowing external sources is rejected.
 def test_enterprise_policy_external_allowed(valid_policy_data):
     valid_policy_data["external_source_forbidden"] = False
-    with pytest.raises(ValueError, match="enterprise-clean policy requires external_source_forbidden=true"):
+    with pytest.raises(
+        ValueError,
+        match="enterprise-clean policy requires external_source_forbidden=true",
+    ):
         CleanProfilePolicy(**valid_policy_data)
 
+
 # @TEST_INVARIANT: manifest_consistency
 # @TEST_EDGE: manifest_count_mismatch
 # [/DEF:test_enterprise_policy_external_allowed:Function]
 
+
 # [DEF:test_manifest_count_mismatch:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify that a manifest with count mismatches is rejected.
 def test_manifest_count_mismatch():
-    summary = ManifestSummary(included_count=1, excluded_count=0, prohibited_detected_count=0)
-    item = ManifestItem(path="p", category="c", classification=ClassificationType.ALLOWED, reason="r")
-    
+    summary = ManifestSummary(
+        included_count=1, excluded_count=0, prohibited_detected_count=0
+    )
+    item = ManifestItem(
+        path="p", category="c", classification=ClassificationType.ALLOWED, reason="r"
+    )
+
     # Valid
     DistributionManifest(
-        manifest_id="m1", candidate_id="rc1", policy_id="p1", 
-        generated_at=datetime.now(), generated_by="u", items=[item], 
-        summary=summary, deterministic_hash="h"
+        manifest_id="m1",
+        candidate_id="rc1",
+        policy_id="p1",
+        generated_at=datetime.now(),
+        generated_by="u",
+        items=[item],
+        summary=summary,
+        deterministic_hash="h",
     )
-    
+
     # Invalid count
     summary.included_count = 2
-    with pytest.raises(ValueError, match="manifest summary counts must match items size"):
+    with pytest.raises(
+        ValueError, match="manifest summary counts must match items size"
+    ):
         DistributionManifest(
-            manifest_id="m1", candidate_id="rc1", policy_id="p1", 
-            generated_at=datetime.now(), generated_by="u", items=[item], 
-            summary=summary, deterministic_hash="h"
+            manifest_id="m1",
+            candidate_id="rc1",
+            policy_id="p1",
+            generated_at=datetime.now(),
+            generated_by="u",
+            items=[item],
+            summary=summary,
+            deterministic_hash="h",
         )
 
+
 # @TEST_INVARIANT: run_integrity
 # @TEST_EDGE: compliant_run_stage_fail
 # [/DEF:test_manifest_count_mismatch:Function]
 
+
 # [DEF:test_compliant_run_validation:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify compliant run validation logic and mandatory stage checks.
 def test_compliant_run_validation():
     base_run = {
@@ -144,45 +181,69 @@ def test_compliant_run_validation():
         "execution_mode": ExecutionMode.TUI,
         "final_status": CheckFinalStatus.COMPLIANT,
         "checks": [
-            CheckStageResult(stage=CheckStageName.DATA_PURITY, status=CheckStageStatus.PASS),
-            CheckStageResult(stage=CheckStageName.INTERNAL_SOURCES_ONLY, status=CheckStageStatus.PASS),
-            CheckStageResult(stage=CheckStageName.NO_EXTERNAL_ENDPOINTS, status=CheckStageStatus.PASS),
-            CheckStageResult(stage=CheckStageName.MANIFEST_CONSISTENCY, status=CheckStageStatus.PASS),
-        ]
+            CheckStageResult(
+                stage=CheckStageName.DATA_PURITY, status=CheckStageStatus.PASS
+            ),
+            CheckStageResult(
+                stage=CheckStageName.INTERNAL_SOURCES_ONLY, status=CheckStageStatus.PASS
+            ),
+            CheckStageResult(
+                stage=CheckStageName.NO_EXTERNAL_ENDPOINTS, status=CheckStageStatus.PASS
+            ),
+            CheckStageResult(
+                stage=CheckStageName.MANIFEST_CONSISTENCY, status=CheckStageStatus.PASS
+            ),
+        ],
     }
     # Valid
     ComplianceCheckRun(**base_run)
-    
+
     # One stage fails -> cannot be COMPLIANT
     base_run["checks"][0].status = CheckStageStatus.FAIL
-    with pytest.raises(ValueError, match="compliant run requires PASS on all mandatory stages"):
+    with pytest.raises(
+        ValueError, match="compliant run requires PASS on all mandatory stages"
+    ):
         ComplianceCheckRun(**base_run)
-        
+
     # Missing stage -> cannot be COMPLIANT
     base_run["checks"] = base_run["checks"][1:]
     with pytest.raises(ValueError, match="compliant run requires all mandatory stages"):
         ComplianceCheckRun(**base_run)
 
+
 # [/DEF:test_compliant_run_validation:Function]
 
+
 # [DEF:test_report_validation:Function]
-# @RELATION: BINDS_TO -> __tests__/test_clean_release
+# @RELATION: BINDS_TO -> [TestCleanReleaseModels]
 # @PURPOSE: Verify compliance report validation based on status and violation counts.
 def test_report_validation():
     # Valid blocked report
     ComplianceReport(
-        report_id="rep1", check_run_id="run1", candidate_id="rc1",
-        generated_at=datetime.now(), final_status=CheckFinalStatus.BLOCKED,
-        operator_summary="Blocked", structured_payload_ref="ref",
-        violations_count=2, blocking_violations_count=2
+        report_id="rep1",
+        check_run_id="run1",
+        candidate_id="rc1",
+        generated_at=datetime.now(),
+        final_status=CheckFinalStatus.BLOCKED,
+        operator_summary="Blocked",
+        structured_payload_ref="ref",
+        violations_count=2,
+        blocking_violations_count=2,
     )
-    
+
     # BLOCKED with 0 blocking violations
     with pytest.raises(ValueError, match="blocked report requires blocking violations"):
         ComplianceReport(
-            report_id="rep1", check_run_id="run1", candidate_id="rc1",
-            generated_at=datetime.now(), final_status=CheckFinalStatus.BLOCKED,
-            operator_summary="Blocked", structured_payload_ref="ref",
-            violations_count=2, blocking_violations_count=0
+            report_id="rep1",
+            check_run_id="run1",
+            candidate_id="rc1",
+            generated_at=datetime.now(),
+            final_status=CheckFinalStatus.BLOCKED,
+            operator_summary="Blocked",
+            structured_payload_ref="ref",
+            violations_count=2,
+            blocking_violations_count=0,
         )
+
+
 # [/DEF:test_report_validation:Function]
diff --git a/backend/src/models/__tests__/test_models.py b/backend/src/models/__tests__/test_models.py
index 68d57849..fd3e321a 100644
--- a/backend/src/models/__tests__/test_models.py
+++ b/backend/src/models/__tests__/test_models.py
@@ -2,7 +2,7 @@
 # @COMPLEXITY: 1
 # @PURPOSE: Unit tests for data models
 # @LAYER: Domain
-# @RELATION: VERIFIES -> src.models
+# @RELATION: VERIFIES -> [ModelsPackage]
 
 import sys
 from pathlib import Path
@@ -26,11 +26,13 @@ def test_environment_model():
             name="test-env",
             url="http://localhost:8088/api/v1",
             username="admin",
-            password="password"
+            password="password",
         )
         assert env.id == "test-id"
         assert env.name == "test-env"
         assert env.url == "http://localhost:8088/api/v1"
+
+
 # [/DEF:test_environment_model:Function]
 
 
diff --git a/backend/src/schemas/__init__.py b/backend/src/schemas/__init__.py
index cb4a2ff5..0fddfa24 100644
--- a/backend/src/schemas/__init__.py
+++ b/backend/src/schemas/__init__.py
@@ -1,3 +1,3 @@
-# [DEF:src.schemas:Package]
+# [DEF:SchemasPackage:Package]
 # @PURPOSE: API schema package root.
-# [/DEF:src.schemas:Package]
+# [/DEF:SchemasPackage:Package]
diff --git a/backend/src/schemas/auth.py b/backend/src/schemas/auth.py
index 3c4bcf08..05dcc89a 100644
--- a/backend/src/schemas/auth.py
+++ b/backend/src/schemas/auth.py
@@ -1,4 +1,4 @@
-# [DEF:backend.src.schemas.auth:Module]
+# [DEF:AuthSchemas:Module]
 #
 # @COMPLEXITY: 3
 # @SEMANTICS: auth, schemas, pydantic, user, token
@@ -14,22 +14,29 @@ from pydantic import BaseModel, EmailStr
 from datetime import datetime
 # [/SECTION]
 
+
 # [DEF:Token:Class]
 # @COMPLEXITY: 1
 # @PURPOSE: Represents a JWT access token response.
 class Token(BaseModel):
     access_token: str
     token_type: str
+
+
 # [/DEF:Token:Class]
 
+
 # [DEF:TokenData:Class]
 # @COMPLEXITY: 1
 # @PURPOSE: Represents the data encoded in a JWT token.
 class TokenData(BaseModel):
     username: Optional[str] = None
     scopes: List[str] = []
+
+
 # [/DEF:TokenData:Class]
 
+
 # [DEF:PermissionSchema:Class]
 # @COMPLEXITY: 1
 # @PURPOSE: Represents a permission in API responses.
@@ -40,8 +47,11 @@ class PermissionSchema(BaseModel):
 
     class Config:
         from_attributes = True
+
+
 # [/DEF:PermissionSchema:Class]
 
+
 # [DEF:RoleSchema:Class]
 # @PURPOSE: Represents a role in API responses.
 class RoleSchema(BaseModel):
@@ -52,24 +62,33 @@ class RoleSchema(BaseModel):
 
     class Config:
         from_attributes = True
+
+
 # [/DEF:RoleSchema:Class]
 
+
 # [DEF:RoleCreate:Class]
 # @PURPOSE: Schema for creating a new role.
 class RoleCreate(BaseModel):
     name: str
     description: Optional[str] = None
-    permissions: List[str] = [] # List of permission IDs or "resource:action" strings
+    permissions: List[str] = []  # List of permission IDs or "resource:action" strings
+
+
 # [/DEF:RoleCreate:Class]
 
+
 # [DEF:RoleUpdate:Class]
 # @PURPOSE: Schema for updating an existing role.
 class RoleUpdate(BaseModel):
     name: Optional[str] = None
     description: Optional[str] = None
     permissions: Optional[List[str]] = None
+
+
 # [/DEF:RoleUpdate:Class]
 
+
 # [DEF:ADGroupMappingSchema:Class]
 # @PURPOSE: Represents an AD Group to Role mapping in API responses.
 class ADGroupMappingSchema(BaseModel):
@@ -79,30 +98,42 @@ class ADGroupMappingSchema(BaseModel):
 
     class Config:
         from_attributes = True
+
+
 # [/DEF:ADGroupMappingSchema:Class]
 
+
 # [DEF:ADGroupMappingCreate:Class]
 # @PURPOSE: Schema for creating an AD Group mapping.
 class ADGroupMappingCreate(BaseModel):
     ad_group: str
     role_id: str
+
+
 # [/DEF:ADGroupMappingCreate:Class]
 
+
 # [DEF:UserBase:Class]
 # @PURPOSE: Base schema for user data.
 class UserBase(BaseModel):
     username: str
     email: Optional[EmailStr] = None
     is_active: bool = True
+
+
 # [/DEF:UserBase:Class]
 
+
 # [DEF:UserCreate:Class]
 # @PURPOSE: Schema for creating a new user.
 class UserCreate(UserBase):
     password: str
     roles: List[str] = []
+
+
 # [/DEF:UserCreate:Class]
 
+
 # [DEF:UserUpdate:Class]
 # @PURPOSE: Schema for updating an existing user.
 class UserUpdate(BaseModel):
@@ -110,8 +141,11 @@ class UserUpdate(BaseModel):
     password: Optional[str] = None
     is_active: Optional[bool] = None
     roles: Optional[List[str]] = None
+
+
 # [/DEF:UserUpdate:Class]
 
+
 # [DEF:User:Class]
 # @PURPOSE: Schema for user data in API responses.
 class User(UserBase):
@@ -123,6 +157,8 @@ class User(UserBase):
 
     class Config:
         from_attributes = True
+
+
 # [/DEF:User:Class]
 
-# [/DEF:backend.src.schemas.auth:Module]
\ No newline at end of file
+# [/DEF:AuthSchemas:Module]
diff --git a/backend/src/schemas/health.py b/backend/src/schemas/health.py
index 24e14e79..bae6ef90 100644
--- a/backend/src/schemas/health.py
+++ b/backend/src/schemas/health.py
@@ -1,4 +1,4 @@
-# [DEF:backend.src.schemas.health:Module]
+# [DEF:HealthSchemas:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: health, schemas, pydantic
 # @PURPOSE: Pydantic schemas for dashboard health summary.
@@ -8,6 +8,7 @@ from pydantic import BaseModel, Field
 from typing import List, Optional
 from datetime import datetime
 
+
 # [DEF:DashboardHealthItem:Class]
 # @PURPOSE: Represents the latest health status of a single dashboard.
 class DashboardHealthItem(BaseModel):
@@ -20,8 +21,11 @@ class DashboardHealthItem(BaseModel):
     last_check: datetime
     task_id: Optional[str] = None
     summary: Optional[str] = None
+
+
 # [/DEF:DashboardHealthItem:Class]
 
+
 # [DEF:HealthSummaryResponse:Class]
 # @PURPOSE: Aggregated health summary for all dashboards.
 class HealthSummaryResponse(BaseModel):
@@ -30,6 +34,8 @@ class HealthSummaryResponse(BaseModel):
     warn_count: int
     fail_count: int
     unknown_count: int
+
+
 # [/DEF:HealthSummaryResponse:Class]
 
-# [/DEF:backend.src.schemas.health:Module]
+# [/DEF:HealthSchemas:Module]
diff --git a/backend/src/schemas/profile.py b/backend/src/schemas/profile.py
index 8fd36844..534d3d3b 100644
--- a/backend/src/schemas/profile.py
+++ b/backend/src/schemas/profile.py
@@ -1,4 +1,4 @@
-# [DEF:backend.src.schemas.profile:Module]
+# [DEF:ProfileSchemas:Module]
 #
 # @COMPLEXITY: 3
 # @SEMANTICS: profile, schemas, pydantic, preferences, superset, lookup, security, git, ux
@@ -21,6 +21,8 @@ from pydantic import BaseModel, Field
 class ProfilePermissionState(BaseModel):
     key: str
     allowed: bool
+
+
 # [/DEF:ProfilePermissionState:Class]
 
 
@@ -34,6 +36,8 @@ class ProfileSecuritySummary(BaseModel):
     role_source: Optional[str] = None
     roles: List[str] = Field(default_factory=list)
     permissions: List[ProfilePermissionState] = Field(default_factory=list)
+
+
 # [/DEF:ProfileSecuritySummary:Class]
 
 
@@ -65,6 +69,8 @@ class ProfilePreference(BaseModel):
 
     class Config:
         from_attributes = True
+
+
 # [/DEF:ProfilePreference:Class]
 
 
@@ -106,11 +112,11 @@ class ProfilePreferenceUpdateRequest(BaseModel):
         default=None,
         description="Auto-open task drawer when long-running tasks start.",
     )
-    dashboards_table_density: Optional[
-        Literal["compact", "comfortable", "free"]
-    ] = Field(
-        default=None,
-        description="Preferred table density for dashboard listings.",
+    dashboards_table_density: Optional[Literal["compact", "comfortable", "free"]] = (
+        Field(
+            default=None,
+            description="Preferred table density for dashboard listings.",
+        )
     )
     telegram_id: Optional[str] = Field(
         default=None,
@@ -124,6 +130,8 @@ class ProfilePreferenceUpdateRequest(BaseModel):
         default=None,
         description="Whether to send notifications on validation failure.",
     )
+
+
 # [/DEF:ProfilePreferenceUpdateRequest:Class]
 
 
@@ -136,6 +144,8 @@ class ProfilePreferenceResponse(BaseModel):
     validation_errors: List[str] = Field(default_factory=list)
     preference: ProfilePreference
     security: ProfileSecuritySummary = Field(default_factory=ProfileSecuritySummary)
+
+
 # [/DEF:ProfilePreferenceResponse:Class]
 
 
@@ -149,6 +159,8 @@ class SupersetAccountLookupRequest(BaseModel):
     page_size: int = Field(default=20, ge=1, le=100)
     sort_column: str = Field(default="username")
     sort_order: str = Field(default="desc")
+
+
 # [/DEF:SupersetAccountLookupRequest:Class]
 
 
@@ -161,6 +173,8 @@ class SupersetAccountCandidate(BaseModel):
     display_name: Optional[str] = None
     email: Optional[str] = None
     is_active: Optional[bool] = None
+
+
 # [/DEF:SupersetAccountCandidate:Class]
 
 
@@ -175,6 +189,8 @@ class SupersetAccountLookupResponse(BaseModel):
     total: int = Field(ge=0)
     warning: Optional[str] = None
     items: List[SupersetAccountCandidate] = Field(default_factory=list)
+
+
 # [/DEF:SupersetAccountLookupResponse:Class]
 
-# [/DEF:backend.src.schemas.profile:Module]
+# [/DEF:ProfileSchemas:Module]
diff --git a/backend/src/schemas/settings.py b/backend/src/schemas/settings.py
index 8f025bda..eff4c250 100644
--- a/backend/src/schemas/settings.py
+++ b/backend/src/schemas/settings.py
@@ -1,4 +1,4 @@
-# [DEF:backend.src.schemas.settings:Module]
+# [DEF:SettingsSchemas:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: settings, schemas, pydantic, validation
 # @PURPOSE: Pydantic schemas for application settings and automation policies.
@@ -8,37 +8,60 @@ from pydantic import BaseModel, Field
 from typing import List, Optional
 from datetime import datetime, time
 
+
 # [DEF:NotificationChannel:Class]
 # @PURPOSE: Structured notification channel definition for policy-level custom routing.
 class NotificationChannel(BaseModel):
-    type: str = Field(..., description="Notification channel type (e.g., SLACK, SMTP, TELEGRAM)")
-    target: str = Field(..., description="Notification destination (e.g., #alerts, chat id, email)")
+    type: str = Field(
+        ..., description="Notification channel type (e.g., SLACK, SMTP, TELEGRAM)"
+    )
+    target: str = Field(
+        ..., description="Notification destination (e.g., #alerts, chat id, email)"
+    )
+
+
 # [/DEF:NotificationChannel:Class]
 
+
 # [DEF:ValidationPolicyBase:Class]
 # @PURPOSE: Base schema for validation policy data.
 class ValidationPolicyBase(BaseModel):
     name: str = Field(..., description="Name of the policy")
     environment_id: str = Field(..., description="Target Superset environment ID")
     is_active: bool = Field(True, description="Whether the policy is currently active")
-    dashboard_ids: List[str] = Field(..., description="List of dashboard IDs to validate")
-    schedule_days: List[int] = Field(..., description="Days of the week (0-6, 0=Sunday) to run")
+    dashboard_ids: List[str] = Field(
+        ..., description="List of dashboard IDs to validate"
+    )
+    schedule_days: List[int] = Field(
+        ..., description="Days of the week (0-6, 0=Sunday) to run"
+    )
     window_start: time = Field(..., description="Start of the execution window")
     window_end: time = Field(..., description="End of the execution window")
-    notify_owners: bool = Field(True, description="Whether to notify dashboard owners on failure")
+    notify_owners: bool = Field(
+        True, description="Whether to notify dashboard owners on failure"
+    )
     custom_channels: Optional[List[NotificationChannel]] = Field(
         None,
         description="List of additional structured notification channels",
     )
-    alert_condition: str = Field("FAIL_ONLY", description="Condition to trigger alerts: FAIL_ONLY, WARN_AND_FAIL, ALWAYS")
+    alert_condition: str = Field(
+        "FAIL_ONLY",
+        description="Condition to trigger alerts: FAIL_ONLY, WARN_AND_FAIL, ALWAYS",
+    )
+
+
 # [/DEF:ValidationPolicyBase:Class]
 
+
 # [DEF:ValidationPolicyCreate:Class]
 # @PURPOSE: Schema for creating a new validation policy.
 class ValidationPolicyCreate(ValidationPolicyBase):
     pass
+
+
 # [/DEF:ValidationPolicyCreate:Class]
 
+
 # [DEF:ValidationPolicyUpdate:Class]
 # @PURPOSE: Schema for updating an existing validation policy.
 class ValidationPolicyUpdate(BaseModel):
@@ -52,8 +75,11 @@ class ValidationPolicyUpdate(BaseModel):
     notify_owners: Optional[bool] = None
     custom_channels: Optional[List[NotificationChannel]] = None
     alert_condition: Optional[str] = None
+
+
 # [/DEF:ValidationPolicyUpdate:Class]
 
+
 # [DEF:ValidationPolicyResponse:Class]
 # @PURPOSE: Schema for validation policy response data.
 class ValidationPolicyResponse(ValidationPolicyBase):
@@ -63,6 +89,8 @@ class ValidationPolicyResponse(ValidationPolicyBase):
 
     class Config:
         from_attributes = True
+
+
 # [/DEF:ValidationPolicyResponse:Class]
 
-# [/DEF:backend.src.schemas.settings:Module]
\ No newline at end of file
+# [/DEF:SettingsSchemas:Module]
diff --git a/backend/src/scripts/__init__.py b/backend/src/scripts/__init__.py
index d0522090..c26d217a 100644
--- a/backend/src/scripts/__init__.py
+++ b/backend/src/scripts/__init__.py
@@ -1,3 +1,3 @@
-# [DEF:src.scripts:Package]
+# [DEF:ScriptsPackage:Package]
 # @PURPOSE: Script entrypoint package root.
-# [/DEF:src.scripts:Package]
+# [/DEF:ScriptsPackage:Package]
diff --git a/backend/src/scripts/clean_release_cli.py b/backend/src/scripts/clean_release_cli.py
index 6afb6f1d..3bfcb31d 100644
--- a/backend/src/scripts/clean_release_cli.py
+++ b/backend/src/scripts/clean_release_cli.py
@@ -1,4 +1,4 @@
-# [DEF:backend.src.scripts.clean_release_cli:Module]
+# [DEF:CleanReleaseCliScript:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: cli, clean-release, candidate, artifacts, manifest
 # @PURPOSE: Provide headless CLI commands for candidate registration, artifact import and manifest build.
@@ -12,10 +12,18 @@ from datetime import date, datetime, timezone
 from typing import Any, Dict, List, Optional
 
 from ..models.clean_release import CandidateArtifact, ReleaseCandidate
-from ..services.clean_release.approval_service import approve_candidate, reject_candidate
-from ..services.clean_release.compliance_execution_service import ComplianceExecutionService
+from ..services.clean_release.approval_service import (
+    approve_candidate,
+    reject_candidate,
+)
+from ..services.clean_release.compliance_execution_service import (
+    ComplianceExecutionService,
+)
 from ..services.clean_release.enums import CandidateStatus
-from ..services.clean_release.publication_service import publish_candidate, revoke_publication
+from ..services.clean_release.publication_service import (
+    publish_candidate,
+    revoke_publication,
+)
 
 
 # [DEF:build_parser:Function]
@@ -88,6 +96,8 @@ def build_parser() -> argparse.ArgumentParser:
     revoke.add_argument("--json", action="store_true")
 
     return parser
+
+
 # [/DEF:build_parser:Function]
 
 
@@ -97,6 +107,7 @@ def build_parser() -> argparse.ArgumentParser:
 # @POST: Candidate is persisted in DRAFT status.
 def run_candidate_register(args: argparse.Namespace) -> int:
     from ..dependencies import get_clean_release_repository
+
     repository = get_clean_release_repository()
     existing = repository.get_candidate(args.candidate_id)
     if existing is not None:
@@ -114,6 +125,8 @@ def run_candidate_register(args: argparse.Namespace) -> int:
     repository.save_candidate(candidate)
     print(json.dumps({"status": "ok", "candidate_id": candidate.id}))
     return 0
+
+
 # [/DEF:run_candidate_register:Function]
 
 
@@ -123,6 +136,7 @@ def run_candidate_register(args: argparse.Namespace) -> int:
 # @POST: Artifact is persisted for candidate.
 def run_artifact_import(args: argparse.Namespace) -> int:
     from ..dependencies import get_clean_release_repository
+
     repository = get_clean_release_repository()
     candidate = repository.get_candidate(args.candidate_id)
     if candidate is None:
@@ -144,6 +158,8 @@ def run_artifact_import(args: argparse.Namespace) -> int:
 
     print(json.dumps({"status": "ok", "artifact_id": artifact.id}))
     return 0
+
+
 # [/DEF:run_artifact_import:Function]
 
 
@@ -166,8 +182,18 @@ def run_manifest_build(args: argparse.Namespace) -> int:
         print(json.dumps({"status": "error", "message": str(exc)}))
         return 1
 
-    print(json.dumps({"status": "ok", "manifest_id": manifest.id, "version": manifest.manifest_version}))
+    print(
+        json.dumps(
+            {
+                "status": "ok",
+                "manifest_id": manifest.id,
+                "version": manifest.manifest_version,
+            }
+        )
+    )
     return 0
+
+
 # [/DEF:run_manifest_build:Function]
 
 
@@ -180,7 +206,9 @@ def run_compliance_run(args: argparse.Namespace) -> int:
 
     repository = get_clean_release_repository()
     config_manager = get_config_manager()
-    service = ComplianceExecutionService(repository=repository, config_manager=config_manager)
+    service = ComplianceExecutionService(
+        repository=repository, config_manager=config_manager
+    )
 
     try:
         result = service.execute_run(
@@ -203,6 +231,8 @@ def run_compliance_run(args: argparse.Namespace) -> int:
     }
     print(json.dumps(payload))
     return 0
+
+
 # [/DEF:run_compliance_run:Function]
 
 
@@ -219,7 +249,9 @@ def run_compliance_status(args: argparse.Namespace) -> int:
         print(json.dumps({"status": "error", "message": "run not found"}))
         return 2
 
-    report = next((item for item in repository.reports.values() if item.run_id == run.id), None)
+    report = next(
+        (item for item in repository.reports.values() if item.run_id == run.id), None
+    )
     payload = {
         "status": "ok",
         "run_id": run.id,
@@ -231,6 +263,8 @@ def run_compliance_status(args: argparse.Namespace) -> int:
     }
     print(json.dumps(payload))
     return 0
+
+
 # [/DEF:run_compliance_status:Function]
 
 
@@ -259,6 +293,8 @@ def _to_payload(value: Any) -> Dict[str, Any]:
         row = {column.name: getattr(value, column.name) for column in table.columns}
         return _normalize(row)
     raise TypeError(f"unsupported payload type: {type(value)!r}")
+
+
 # [/DEF:_to_payload:Function]
 
 
@@ -275,13 +311,17 @@ def run_compliance_report(args: argparse.Namespace) -> int:
         print(json.dumps({"status": "error", "message": "run not found"}))
         return 2
 
-    report = next((item for item in repository.reports.values() if item.run_id == run.id), None)
+    report = next(
+        (item for item in repository.reports.values() if item.run_id == run.id), None
+    )
     if report is None:
         print(json.dumps({"status": "error", "message": "report not found"}))
         return 2
 
     print(json.dumps({"status": "ok", "report": _to_payload(report)}))
     return 0
+
+
 # [/DEF:run_compliance_report:Function]
 
 
@@ -299,8 +339,14 @@ def run_compliance_violations(args: argparse.Namespace) -> int:
         return 2
 
     violations = repository.get_violations_by_run(args.run_id)
-    print(json.dumps({"status": "ok", "items": [_to_payload(item) for item in violations]}))
+    print(
+        json.dumps(
+            {"status": "ok", "items": [_to_payload(item) for item in violations]}
+        )
+    )
     return 0
+
+
 # [/DEF:run_compliance_violations:Function]
 
 
@@ -324,8 +370,14 @@ def run_approve(args: argparse.Namespace) -> int:
         print(json.dumps({"status": "error", "message": str(exc)}))
         return 2
 
-    print(json.dumps({"status": "ok", "decision": decision.decision, "decision_id": decision.id}))
+    print(
+        json.dumps(
+            {"status": "ok", "decision": decision.decision, "decision_id": decision.id}
+        )
+    )
     return 0
+
+
 # [/DEF:run_approve:Function]
 
 
@@ -349,8 +401,14 @@ def run_reject(args: argparse.Namespace) -> int:
         print(json.dumps({"status": "error", "message": str(exc)}))
         return 2
 
-    print(json.dumps({"status": "ok", "decision": decision.decision, "decision_id": decision.id}))
+    print(
+        json.dumps(
+            {"status": "ok", "decision": decision.decision, "decision_id": decision.id}
+        )
+    )
     return 0
+
+
 # [/DEF:run_reject:Function]
 
 
@@ -377,6 +435,8 @@ def run_publish(args: argparse.Namespace) -> int:
 
     print(json.dumps({"status": "ok", "publication": _to_payload(publication)}))
     return 0
+
+
 # [/DEF:run_publish:Function]
 
 
@@ -401,6 +461,8 @@ def run_revoke(args: argparse.Namespace) -> int:
 
     print(json.dumps({"status": "ok", "publication": _to_payload(publication)}))
     return 0
+
+
 # [/DEF:run_revoke:Function]
 
 
@@ -435,10 +497,12 @@ def main(argv: Optional[List[str]] = None) -> int:
 
     print(json.dumps({"status": "error", "message": "unknown command"}))
     return 2
+
+
 # [/DEF:main:Function]
 
 
 if __name__ == "__main__":
     raise SystemExit(main())
 
-# [/DEF:backend.src.scripts.clean_release_cli:Module]
\ No newline at end of file
+# [/DEF:CleanReleaseCliScript:Module]
diff --git a/backend/src/scripts/clean_release_tui.py b/backend/src/scripts/clean_release_tui.py
index a59d4cc0..c3aac725 100644
--- a/backend/src/scripts/clean_release_tui.py
+++ b/backend/src/scripts/clean_release_tui.py
@@ -1,10 +1,10 @@
-# [DEF:backend.src.scripts.clean_release_tui:Module]
+# [DEF:CleanReleaseTuiScript:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, tui, ncurses, interactive-validator
 # @PURPOSE: Interactive terminal interface for Enterprise Clean Release compliance validation.
 # @LAYER: UI
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.compliance_orchestrator
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
+# @RELATION: DEPENDS_ON -> [compliance_orchestrator]
+# @RELATION: DEPENDS_ON -> [repository]
 # @INVARIANT: TUI refuses startup in non-TTY environments; headless flow is CLI/API only.
 
 import curses
@@ -37,12 +37,15 @@ from src.models.clean_release import (
 )
 from src.services.clean_release.approval_service import approve_candidate
 from src.services.clean_release.artifact_catalog_loader import load_bootstrap_artifacts
-from src.services.clean_release.compliance_execution_service import ComplianceExecutionService
+from src.services.clean_release.compliance_execution_service import (
+    ComplianceExecutionService,
+)
 from src.services.clean_release.enums import CandidateStatus
 from src.services.clean_release.manifest_service import build_manifest_snapshot
 from src.services.clean_release.publication_service import publish_candidate
 from src.services.clean_release.repository import CleanReleaseRepository
 
+
 # [DEF:TuiFacadeAdapter:Class]
 # @PURPOSE: Thin TUI adapter that routes business mutations through application services.
 # @PRE: repository contains candidate and trusted policy/registry snapshots for execution.
@@ -67,15 +70,25 @@ class TuiFacadeAdapter:
         manifests = self.repository.get_manifests_by_candidate(candidate_id)
         if not manifests:
             raise ValueError("Manifest required before compliance run")
-        latest_manifest = sorted(manifests, key=lambda item: item.manifest_version, reverse=True)[0]
+        latest_manifest = sorted(
+            manifests, key=lambda item: item.manifest_version, reverse=True
+        )[0]
         service = ComplianceExecutionService(
             repository=self.repository,
             config_manager=self._build_config_manager(),
         )
-        return service.execute_run(candidate_id=candidate_id, requested_by=actor, manifest_id=latest_manifest.id)
+        return service.execute_run(
+            candidate_id=candidate_id,
+            requested_by=actor,
+            manifest_id=latest_manifest.id,
+        )
 
     def approve_latest(self, *, candidate_id: str, actor: str):
-        reports = [item for item in self.repository.reports.values() if item.candidate_id == candidate_id]
+        reports = [
+            item
+            for item in self.repository.reports.values()
+            if item.candidate_id == candidate_id
+        ]
         if not reports:
             raise ValueError("No compliance report available for approval")
         report = sorted(reports, key=lambda item: item.generated_at, reverse=True)[0]
@@ -88,7 +101,11 @@ class TuiFacadeAdapter:
         )
 
     def publish_latest(self, *, candidate_id: str, actor: str):
-        reports = [item for item in self.repository.reports.values() if item.candidate_id == candidate_id]
+        reports = [
+            item
+            for item in self.repository.reports.values()
+            if item.candidate_id == candidate_id
+        ]
         if not reports:
             raise ValueError("No compliance report available for publication")
         report = sorted(reports, key=lambda item: item.generated_at, reverse=True)[0]
@@ -111,24 +128,55 @@ class TuiFacadeAdapter:
     def get_overview(self, *, candidate_id: str) -> Dict[str, Any]:
         candidate = self.repository.get_candidate(candidate_id)
         manifests = self.repository.get_manifests_by_candidate(candidate_id)
-        latest_manifest = sorted(manifests, key=lambda item: item.manifest_version, reverse=True)[0] if manifests else None
-        runs = [item for item in self.repository.check_runs.values() if item.candidate_id == candidate_id]
-        latest_run = sorted(runs, key=lambda item: item.requested_at, reverse=True)[0] if runs else None
-        latest_report = next((item for item in self.repository.reports.values() if latest_run and item.run_id == latest_run.id), None)
+        latest_manifest = (
+            sorted(manifests, key=lambda item: item.manifest_version, reverse=True)[0]
+            if manifests
+            else None
+        )
+        runs = [
+            item
+            for item in self.repository.check_runs.values()
+            if item.candidate_id == candidate_id
+        ]
+        latest_run = (
+            sorted(runs, key=lambda item: item.requested_at, reverse=True)[0]
+            if runs
+            else None
+        )
+        latest_report = next(
+            (
+                item
+                for item in self.repository.reports.values()
+                if latest_run and item.run_id == latest_run.id
+            ),
+            None,
+        )
         approvals = getattr(self.repository, "approval_decisions", [])
-        latest_approval = sorted(
-            [item for item in approvals if item.candidate_id == candidate_id],
-            key=lambda item: item.decided_at,
-            reverse=True,
-        )[0] if any(item.candidate_id == candidate_id for item in approvals) else None
+        latest_approval = (
+            sorted(
+                [item for item in approvals if item.candidate_id == candidate_id],
+                key=lambda item: item.decided_at,
+                reverse=True,
+            )[0]
+            if any(item.candidate_id == candidate_id for item in approvals)
+            else None
+        )
         publications = getattr(self.repository, "publication_records", [])
-        latest_publication = sorted(
-            [item for item in publications if item.candidate_id == candidate_id],
-            key=lambda item: item.published_at,
-            reverse=True,
-        )[0] if any(item.candidate_id == candidate_id for item in publications) else None
+        latest_publication = (
+            sorted(
+                [item for item in publications if item.candidate_id == candidate_id],
+                key=lambda item: item.published_at,
+                reverse=True,
+            )[0]
+            if any(item.candidate_id == candidate_id for item in publications)
+            else None
+        )
         policy = self.repository.get_active_policy()
-        registry = self.repository.get_registry(policy.internal_source_registry_ref) if policy else None
+        registry = (
+            self.repository.get_registry(policy.internal_source_registry_ref)
+            if policy
+            else None
+        )
         return {
             "candidate": candidate,
             "manifest": latest_manifest,
@@ -139,6 +187,8 @@ class TuiFacadeAdapter:
             "policy": policy,
             "registry": registry,
         }
+
+
 # [/DEF:TuiFacadeAdapter:Class]
 
 
@@ -166,11 +216,11 @@ class CleanReleaseTUI:
 
         curses.start_color()
         curses.use_default_colors()
-        curses.init_pair(1, curses.COLOR_WHITE, curses.COLOR_BLUE) # Header/Footer
-        curses.init_pair(2, curses.COLOR_GREEN, -1) # PASS
-        curses.init_pair(3, curses.COLOR_RED, -1) # FAIL/BLOCKED
-        curses.init_pair(4, curses.COLOR_YELLOW, -1) # RUNNING
-        curses.init_pair(5, curses.COLOR_CYAN, -1) # Text
+        curses.init_pair(1, curses.COLOR_WHITE, curses.COLOR_BLUE)  # Header/Footer
+        curses.init_pair(2, curses.COLOR_GREEN, -1)  # PASS
+        curses.init_pair(3, curses.COLOR_RED, -1)  # FAIL/BLOCKED
+        curses.init_pair(4, curses.COLOR_YELLOW, -1)  # RUNNING
+        curses.init_pair(5, curses.COLOR_CYAN, -1)  # Text
 
     def _build_repository(self, mode: str) -> CleanReleaseRepository:
         repo = CleanReleaseRepository()
@@ -317,7 +367,9 @@ class CleanReleaseTUI:
                         "prohibited_artifact_categories",
                         ["test-data", "demo", "load-test"],
                     ),
-                    required_system_categories=payload.get("required_system_categories", ["core"]),
+                    required_system_categories=payload.get(
+                        "required_system_categories", ["core"]
+                    ),
                     effective_from=now,
                 )
             )
@@ -354,18 +406,21 @@ class CleanReleaseTUI:
         self.stdscr.addstr(4, 3, "Checks:")
         check_defs = [
             (CheckStageName.DATA_PURITY, "Data Purity (no test/demo payloads)"),
-            (CheckStageName.INTERNAL_SOURCES_ONLY, "Internal Sources Only (company servers)"),
+            (
+                CheckStageName.INTERNAL_SOURCES_ONLY,
+                "Internal Sources Only (company servers)",
+            ),
             (CheckStageName.NO_EXTERNAL_ENDPOINTS, "No External Internet Endpoints"),
             (CheckStageName.MANIFEST_CONSISTENCY, "Release Manifest Consistency"),
         ]
-        
+
         row = 5
         drawn_checks = {c["stage"]: c for c in self.checks_progress}
-        
+
         for stage, desc in check_defs:
             status_text = " "
             color = curses.color_pair(5)
-            
+
             if stage in drawn_checks:
                 c = drawn_checks[stage]
                 if c["status"] == "RUNNING":
@@ -377,7 +432,7 @@ class CleanReleaseTUI:
                 elif c["status"] == CheckStageStatus.FAIL:
                     status_text = "FAIL"
                     color = curses.color_pair(3)
-            
+
             self.stdscr.addstr(row, 4, f"[{status_text:^4}] {desc}")
             if status_text != " ":
                 self.stdscr.addstr(row, 50, f"{status_text:>10}", color | curses.A_BOLD)
@@ -396,12 +451,18 @@ class CleanReleaseTUI:
 
     def draw_status(self):
         color = curses.color_pair(5)
-        if self.status == CheckFinalStatus.COMPLIANT: color = curses.color_pair(2)
-        elif self.status == CheckFinalStatus.BLOCKED: color = curses.color_pair(3)
-        
-        stat_str = str(self.status.value if hasattr(self.status, "value") else self.status)
-        self.stdscr.addstr(18, 3, f"FINAL STATUS: {stat_str.upper()}", color | curses.A_BOLD)
-        
+        if self.status == CheckFinalStatus.COMPLIANT:
+            color = curses.color_pair(2)
+        elif self.status == CheckFinalStatus.BLOCKED:
+            color = curses.color_pair(3)
+
+        stat_str = str(
+            self.status.value if hasattr(self.status, "value") else self.status
+        )
+        self.stdscr.addstr(
+            18, 3, f"FINAL STATUS: {stat_str.upper()}", color | curses.A_BOLD
+        )
+
         if self.report_id:
             self.stdscr.addstr(19, 3, f"Report ID: {self.report_id}")
 
@@ -413,22 +474,36 @@ class CleanReleaseTUI:
             self.stdscr.addstr(20, 32, f"Publication: {publication.status}")
 
         if self.violations_list:
-            self.stdscr.addstr(21, 3, f"Violations Details ({len(self.violations_list)} total):", curses.color_pair(3) | curses.A_BOLD)
+            self.stdscr.addstr(
+                21,
+                3,
+                f"Violations Details ({len(self.violations_list)} total):",
+                curses.color_pair(3) | curses.A_BOLD,
+            )
             row = 22
             for i, v in enumerate(self.violations_list[:5]):
                 v_cat = str(getattr(v, "code", "VIOLATION"))
                 msg = str(getattr(v, "message", "Violation detected"))
                 location = str(
                     getattr(v, "artifact_path", "")
-                    or getattr(getattr(v, "evidence_json", {}), "get", lambda *_: "")("location", "")
+                    or getattr(getattr(v, "evidence_json", {}), "get", lambda *_: "")(
+                        "location", ""
+                    )
                 )
                 msg_text = f"[{v_cat}] {msg} (Loc: {location})"
                 self.stdscr.addstr(row + i, 5, msg_text[:70], curses.color_pair(3))
         if self.last_error:
-            self.stdscr.addstr(27, 3, f"Error: {self.last_error}"[:100], curses.color_pair(3) | curses.A_BOLD)
+            self.stdscr.addstr(
+                27,
+                3,
+                f"Error: {self.last_error}"[:100],
+                curses.color_pair(3) | curses.A_BOLD,
+            )
 
     def draw_footer(self, max_y: int, max_x: int):
-        footer_text = " F5 Run   F6 Manifest   F7 Refresh   F8 Approve   F9 Publish   F10 Exit ".center(max_x)
+        footer_text = " F5 Run   F6 Manifest   F7 Refresh   F8 Approve   F9 Publish   F10 Exit ".center(
+            max_x
+        )
         self.stdscr.attron(curses.color_pair(1))
         self.stdscr.addstr(max_y - 1, 0, footer_text[:max_x])
         self.stdscr.attroff(curses.color_pair(1))
@@ -446,7 +521,9 @@ class CleanReleaseTUI:
         self.refresh_screen()
 
         try:
-            result = self.facade.run_compliance(candidate_id=self.candidate_id, actor="operator")
+            result = self.facade.run_compliance(
+                candidate_id=self.candidate_id, actor="operator"
+            )
         except Exception as exc:  # noqa: BLE001
             self.status = CheckFinalStatus.FAILED
             self.last_error = str(exc)
@@ -456,7 +533,9 @@ class CleanReleaseTUI:
         self.checks_progress = [
             {
                 "stage": stage.stage_name,
-                "status": CheckStageStatus.PASS if str(stage.decision).upper() == "PASSED" else CheckStageStatus.FAIL,
+                "status": CheckStageStatus.PASS
+                if str(stage.decision).upper() == "PASSED"
+                else CheckStageStatus.FAIL,
             }
             for stage in result.stage_runs
         ]
@@ -472,11 +551,14 @@ class CleanReleaseTUI:
             self.status = CheckFinalStatus.FAILED
         self.refresh_overview()
         self.refresh_screen()
+
     # [/DEF:run_checks:Function]
 
     def build_manifest(self):
         try:
-            manifest = self.facade.build_manifest(candidate_id=self.candidate_id, actor="operator")
+            manifest = self.facade.build_manifest(
+                candidate_id=self.candidate_id, actor="operator"
+            )
             self.status = "READY"
             self.report_id = None
             self.violations_list = []
@@ -570,11 +652,13 @@ class CleanReleaseTUI:
                 self.approve_latest()
             elif char == curses.KEY_F9:
                 self.publish_latest()
+
+
 # [/DEF:CleanReleaseTUI:Class]
 
 
 def tui_main(stdscr: curses.window):
-    curses.curs_set(0) # Hide cursor
+    curses.curs_set(0)  # Hide cursor
     app = CleanReleaseTUI(stdscr)
     app.loop()
 
@@ -597,4 +681,4 @@ def main() -> int:
 
 if __name__ == "__main__":
     sys.exit(main())
-# [/DEF:backend.src.scripts.clean_release_tui:Module]
+# [/DEF:CleanReleaseTuiScript:Module]
diff --git a/backend/src/scripts/create_admin.py b/backend/src/scripts/create_admin.py
index 95f699a7..9e9c2428 100644
--- a/backend/src/scripts/create_admin.py
+++ b/backend/src/scripts/create_admin.py
@@ -1,12 +1,12 @@
-# [DEF:backend.src.scripts.create_admin:Module]
+# [DEF:CreateAdminScript:Module]
 #
 # @COMPLEXITY: 3
 # @SEMANTICS: admin, setup, user, auth, cli
 # @PURPOSE:   CLI tool for creating the initial admin user.
 # @LAYER:     Scripts
-# @RELATION:  USES -> backend.src.core.auth.security
-# @RELATION:  USES -> backend.src.core.database
-# @RELATION:  USES -> backend.src.models.auth
+# @RELATION:  USES -> [AuthSecurityModule]
+# @RELATION:  USES -> [DatabaseModule]
+# @RELATION:  USES -> [AuthModels]
 #
 # @INVARIANT: Admin user must have the "Admin" role.
 
@@ -24,6 +24,7 @@ from src.models.auth import User, Role
 from src.core.logger import logger, belief_scope
 # [/SECTION]
 
+
 # [DEF:create_admin:Function]
 # @PURPOSE: Creates an admin user and necessary roles/permissions.
 # @PRE:     username and password provided via CLI.
@@ -36,7 +37,9 @@ def create_admin(username, password, email=None):
     with belief_scope("create_admin"):
         db = AuthSessionLocal()
         try:
-            normalized_email = email.strip() if isinstance(email, str) and email.strip() else None
+            normalized_email = (
+                email.strip() if isinstance(email, str) and email.strip() else None
+            )
 
             # 1. Ensure Admin role exists
             admin_role = db.query(Role).filter(Role.name == "Admin").first()
@@ -60,7 +63,7 @@ def create_admin(username, password, email=None):
                 email=normalized_email,
                 password_hash=get_password_hash(password),
                 auth_source="LOCAL",
-                is_active=True
+                is_active=True,
             )
             new_user.roles.append(admin_role)
             db.add(new_user)
@@ -74,6 +77,8 @@ def create_admin(username, password, email=None):
             raise
         finally:
             db.close()
+
+
 # [/DEF:create_admin:Function]
 
 if __name__ == "__main__":
@@ -91,4 +96,4 @@ if __name__ == "__main__":
     except Exception:
         sys.exit(1)
 
-# [/DEF:backend.src.scripts.create_admin:Module]
\ No newline at end of file
+# [/DEF:CreateAdminScript:Module]
diff --git a/backend/src/scripts/dataset_dashboard_analysis.json b/backend/src/scripts/dataset_dashboard_analysis.json
index 12bdda36..614343e0 100644
--- a/backend/src/scripts/dataset_dashboard_analysis.json
+++ b/backend/src/scripts/dataset_dashboard_analysis.json
@@ -10,7 +10,7 @@
       },
       "changed_by_name": "Superset Admin",
       "changed_on": "2026-02-24T19:24:01.850617",
-      "changed_on_delta_humanized": "20 days ago",
+      "changed_on_delta_humanized": "29 days ago",
       "charts": [
         "TA-0001-001 test_chart"
       ],
@@ -19,7 +19,7 @@
         "id": 1,
         "last_name": "Admin"
       },
-      "created_on_delta_humanized": "26 days ago",
+      "created_on_delta_humanized": "a month ago",
       "css": null,
       "dashboard_title": "TA-0001 Test dashboard",
       "id": 13,
@@ -54,7 +54,7 @@
         "last_name": "Admin"
       },
       "changed_on": "2026-02-18T14:56:04.863722",
-      "changed_on_humanized": "26 days ago",
+      "changed_on_humanized": "a month ago",
       "column_formats": {},
       "columns": [
         {
@@ -424,7 +424,7 @@
         "last_name": "Admin"
       },
       "created_on": "2026-02-18T14:56:04.317950",
-      "created_on_humanized": "26 days ago",
+      "created_on_humanized": "a month ago",
       "database": {
         "allow_multi_catalog": false,
         "backend": "postgresql",
diff --git a/backend/src/scripts/migrate_sqlite_to_postgres.py b/backend/src/scripts/migrate_sqlite_to_postgres.py
index 39c25eb2..0a74d11a 100644
--- a/backend/src/scripts/migrate_sqlite_to_postgres.py
+++ b/backend/src/scripts/migrate_sqlite_to_postgres.py
@@ -1,4 +1,4 @@
-# [DEF:backend.src.scripts.migrate_sqlite_to_postgres:Module]
+# [DEF:MigrateSqliteToPostgresScript:Module]
 #
 # @COMPLEXITY: 3
 # @SEMANTICS: migration, sqlite, postgresql, config, task_logs, task_records
@@ -30,7 +30,10 @@ from src.core.logger import belief_scope, logger
 # [DEF:Constants:Section]
 DEFAULT_TARGET_URL = os.getenv(
     "DATABASE_URL",
-    os.getenv("POSTGRES_URL", "postgresql+psycopg2://postgres:postgres@localhost:5432/ss_tools"),
+    os.getenv(
+        "POSTGRES_URL",
+        "postgresql+psycopg2://postgres:postgres@localhost:5432/ss_tools",
+    ),
 )
 # [/DEF:Constants:Section]
 
@@ -56,6 +59,8 @@ def _json_load_if_needed(value: Any) -> Any:
                 except json.JSONDecodeError:
                     return value
         return value
+
+
 # [/DEF:_json_load_if_needed:Function]
 
 
@@ -75,6 +80,8 @@ def _find_legacy_config_path(explicit_path: Optional[str]) -> Optional[Path]:
             if candidate.exists():
                 return candidate
         return None
+
+
 # [/DEF:_find_legacy_config_path:Function]
 
 
@@ -85,6 +92,8 @@ def _connect_sqlite(path: Path) -> sqlite3.Connection:
         conn = sqlite3.connect(str(path))
         conn.row_factory = sqlite3.Row
         return conn
+
+
 # [/DEF:_connect_sqlite:Function]
 
 
@@ -150,6 +159,8 @@ def _ensure_target_schema(engine) -> None:
         with engine.begin() as conn:
             for stmt in stmts:
                 conn.execute(text(stmt))
+
+
 # [/DEF:_ensure_target_schema:Function]
 
 
@@ -158,7 +169,9 @@ def _ensure_target_schema(engine) -> None:
 def _migrate_config(engine, legacy_config_path: Optional[Path]) -> int:
     with belief_scope("_migrate_config"):
         if legacy_config_path is None:
-            logger.info("[_migrate_config][Action] No legacy config.json found, skipping")
+            logger.info(
+                "[_migrate_config][Action] No legacy config.json found, skipping"
+            )
             return 0
 
         payload = json.loads(legacy_config_path.read_text(encoding="utf-8"))
@@ -174,8 +187,13 @@ def _migrate_config(engine, legacy_config_path: Optional[Path]) -> int:
                 ),
                 {"payload": json.dumps(payload, ensure_ascii=True)},
             )
-        logger.info("[_migrate_config][Coherence:OK] Config migrated from %s", legacy_config_path)
+        logger.info(
+            "[_migrate_config][Coherence:OK] Config migrated from %s",
+            legacy_config_path,
+        )
         return 1
+
+
 # [/DEF:_migrate_config:Function]
 
 
@@ -183,7 +201,12 @@ def _migrate_config(engine, legacy_config_path: Optional[Path]) -> int:
 # @PURPOSE: Migrates task_records and task_logs from SQLite into PostgreSQL.
 def _migrate_tasks_and_logs(engine, sqlite_conn: sqlite3.Connection) -> Dict[str, int]:
     with belief_scope("_migrate_tasks_and_logs"):
-        stats = {"task_records_total": 0, "task_records_inserted": 0, "task_logs_total": 0, "task_logs_inserted": 0}
+        stats = {
+            "task_records_total": 0,
+            "task_records_inserted": 0,
+            "task_logs_total": 0,
+            "task_logs_inserted": 0,
+        }
 
         rows = sqlite_conn.execute(
             """
@@ -228,11 +251,17 @@ def _migrate_tasks_and_logs(engine, sqlite_conn: sqlite3.Connection) -> Dict[str
                         "environment_id": environment_id,
                         "started_at": row["started_at"],
                         "finished_at": row["finished_at"],
-                        "logs": json.dumps(logs_obj, ensure_ascii=True) if logs_obj is not None else None,
+                        "logs": json.dumps(logs_obj, ensure_ascii=True)
+                        if logs_obj is not None
+                        else None,
                         "error": row["error"],
-                        "result": json.dumps(result_obj, ensure_ascii=True) if result_obj is not None else None,
+                        "result": json.dumps(result_obj, ensure_ascii=True)
+                        if result_obj is not None
+                        else None,
                         "created_at": row["created_at"],
-                        "params": json.dumps(params_obj, ensure_ascii=True) if params_obj is not None else None,
+                        "params": json.dumps(params_obj, ensure_ascii=True)
+                        if params_obj is not None
+                        else None,
                     },
                 )
                 if res.rowcount and res.rowcount > 0:
@@ -292,14 +321,20 @@ def _migrate_tasks_and_logs(engine, sqlite_conn: sqlite3.Connection) -> Dict[str
             stats["task_logs_total"],
         )
         return stats
+
+
 # [/DEF:_migrate_tasks_and_logs:Function]
 
 
 # [DEF:run_migration:Function]
 # @PURPOSE: Orchestrates migration from SQLite/file to PostgreSQL.
-def run_migration(sqlite_path: Path, target_url: str, legacy_config_path: Optional[Path]) -> Dict[str, int]:
+def run_migration(
+    sqlite_path: Path, target_url: str, legacy_config_path: Optional[Path]
+) -> Dict[str, int]:
     with belief_scope("run_migration"):
-        logger.info("[run_migration][Entry] sqlite=%s target=%s", sqlite_path, target_url)
+        logger.info(
+            "[run_migration][Entry] sqlite=%s target=%s", sqlite_path, target_url
+        )
         if not sqlite_path.exists():
             raise FileNotFoundError(f"SQLite source not found: {sqlite_path}")
 
@@ -313,6 +348,8 @@ def run_migration(sqlite_path: Path, target_url: str, legacy_config_path: Option
             return stats
         finally:
             sqlite_conn.close()
+
+
 # [/DEF:run_migration:Function]
 
 
@@ -344,7 +381,11 @@ def main() -> int:
         sqlite_path = Path(args.sqlite_path)
         legacy_config_path = _find_legacy_config_path(args.config_path)
         try:
-            stats = run_migration(sqlite_path=sqlite_path, target_url=args.target_url, legacy_config_path=legacy_config_path)
+            stats = run_migration(
+                sqlite_path=sqlite_path,
+                target_url=args.target_url,
+                legacy_config_path=legacy_config_path,
+            )
             print("Migration completed.")
             print(json.dumps(stats, indent=2))
             return 0
@@ -358,4 +399,4 @@ if __name__ == "__main__":
     raise SystemExit(main())
 # [/DEF:main:Function]
 
-# [/DEF:backend.src.scripts.migrate_sqlite_to_postgres:Module]
+# [/DEF:MigrateSqliteToPostgresScript:Module]
diff --git a/backend/src/scripts/seed_superset_load_test.py b/backend/src/scripts/seed_superset_load_test.py
index 08f74007..66e453c0 100644
--- a/backend/src/scripts/seed_superset_load_test.py
+++ b/backend/src/scripts/seed_superset_load_test.py
@@ -1,11 +1,11 @@
-# [DEF:backend.src.scripts.seed_superset_load_test:Module]
+# [DEF:SeedSupersetLoadTestScript:Module]
 #
 # @COMPLEXITY: 3
 # @SEMANTICS: superset, load-test, charts, dashboards, seed, stress
 # @PURPOSE: Creates randomized load-test data in Superset by cloning chart configurations and creating dashboards in target environments.
 # @LAYER: Scripts
-# @RELATION: USES -> backend.src.core.config_manager.ConfigManager
-# @RELATION: USES -> backend.src.core.superset_client.SupersetClient
+# @RELATION: USES -> [ConfigManager]
+# @RELATION: USES -> [SupersetClient]
 # @INVARIANT: Created chart and dashboard names are globally unique for one script run.
 
 # [SECTION: IMPORTS]
@@ -31,15 +31,42 @@ from src.core.superset_client import SupersetClient
 # @PRE: Script is called from CLI.
 # @POST: Returns validated argument namespace.
 def _parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description="Seed Superset with load-test charts and dashboards")
-    parser.add_argument("--envs", nargs="+", default=["ss1", "ss2"], help="Target environment IDs")
-    parser.add_argument("--charts", type=int, default=10000, help="Target number of charts to create")
-    parser.add_argument("--dashboards", type=int, default=500, help="Target number of dashboards to create")
-    parser.add_argument("--template-pool-size", type=int, default=200, help="How many source charts to sample as templates per env")
-    parser.add_argument("--seed", type=int, default=None, help="Optional RNG seed for reproducibility")
-    parser.add_argument("--max-errors", type=int, default=100, help="Stop early if errors exceed this threshold")
-    parser.add_argument("--dry-run", action="store_true", help="Do not write data, only validate setup")
+    parser = argparse.ArgumentParser(
+        description="Seed Superset with load-test charts and dashboards"
+    )
+    parser.add_argument(
+        "--envs", nargs="+", default=["ss1", "ss2"], help="Target environment IDs"
+    )
+    parser.add_argument(
+        "--charts", type=int, default=10000, help="Target number of charts to create"
+    )
+    parser.add_argument(
+        "--dashboards",
+        type=int,
+        default=500,
+        help="Target number of dashboards to create",
+    )
+    parser.add_argument(
+        "--template-pool-size",
+        type=int,
+        default=200,
+        help="How many source charts to sample as templates per env",
+    )
+    parser.add_argument(
+        "--seed", type=int, default=None, help="Optional RNG seed for reproducibility"
+    )
+    parser.add_argument(
+        "--max-errors",
+        type=int,
+        default=100,
+        help="Stop early if errors exceed this threshold",
+    )
+    parser.add_argument(
+        "--dry-run", action="store_true", help="Do not write data, only validate setup"
+    )
     return parser.parse_args()
+
+
 # [/DEF:_parse_args:Function]
 
 
@@ -52,6 +79,8 @@ def _extract_result_payload(payload: Dict) -> Dict:
     if isinstance(result, dict):
         return result
     return payload
+
+
 # [/DEF:_extract_result_payload:Function]
 
 
@@ -67,6 +96,8 @@ def _extract_created_id(payload: Dict) -> Optional[int]:
     if isinstance(result, dict) and isinstance(result.get("id"), int):
         return int(result["id"])
     return None
+
+
 # [/DEF:_extract_created_id:Function]
 
 
@@ -75,14 +106,38 @@ def _extract_created_id(payload: Dict) -> Optional[int]:
 # @PRE: used_names is mutable set for collision tracking.
 # @POST: Returns a unique string and stores it in used_names.
 def _generate_unique_name(prefix: str, used_names: set[str], rng: random.Random) -> str:
-    adjectives = ["amber", "rapid", "frozen", "delta", "lunar", "vector", "cobalt", "silent", "neon", "solar"]
-    nouns = ["falcon", "matrix", "signal", "harbor", "stream", "vertex", "bridge", "orbit", "pulse", "forge"]
+    adjectives = [
+        "amber",
+        "rapid",
+        "frozen",
+        "delta",
+        "lunar",
+        "vector",
+        "cobalt",
+        "silent",
+        "neon",
+        "solar",
+    ]
+    nouns = [
+        "falcon",
+        "matrix",
+        "signal",
+        "harbor",
+        "stream",
+        "vertex",
+        "bridge",
+        "orbit",
+        "pulse",
+        "forge",
+    ]
     while True:
         token = uuid.uuid4().hex[:8]
         candidate = f"{prefix}_{rng.choice(adjectives)}_{rng.choice(nouns)}_{rng.randint(100, 999)}_{token}"
         if candidate not in used_names:
             used_names.add(candidate)
             return candidate
+
+
 # [/DEF:_generate_unique_name:Function]
 
 
@@ -106,7 +161,9 @@ def _resolve_target_envs(env_ids: List[str]) -> Dict[str, Environment]:
                     env = Environment(**row)
                     configured[env.id] = env
             except Exception as exc:
-                logger.warning(f"[REFLECT] Failed loading environments from {config_path}: {exc}")
+                logger.warning(
+                    f"[REFLECT] Failed loading environments from {config_path}: {exc}"
+                )
 
     for env_id in env_ids:
         env = configured.get(env_id)
@@ -115,6 +172,8 @@ def _resolve_target_envs(env_ids: List[str]) -> Dict[str, Environment]:
         resolved[env_id] = env
 
     return resolved
+
+
 # [/DEF:_resolve_target_envs:Function]
 
 
@@ -122,11 +181,21 @@ def _resolve_target_envs(env_ids: List[str]) -> Dict[str, Environment]:
 # @PURPOSE: Builds a pool of source chart templates to clone in one environment.
 # @PRE: Client is authenticated.
 # @POST: Returns non-empty list of chart payload templates.
-def _build_chart_template_pool(client: SupersetClient, pool_size: int, rng: random.Random) -> List[Dict]:
+def _build_chart_template_pool(
+    client: SupersetClient, pool_size: int, rng: random.Random
+) -> List[Dict]:
     list_query = {
         "page": 0,
         "page_size": 1000,
-        "columns": ["id", "slice_name", "datasource_id", "datasource_type", "viz_type", "params", "query_context"],
+        "columns": [
+            "id",
+            "slice_name",
+            "datasource_id",
+            "datasource_type",
+            "viz_type",
+            "params",
+            "query_context",
+        ],
     }
     rows = client.network.fetch_paginated_data(
         endpoint="/chart/",
@@ -137,7 +206,11 @@ def _build_chart_template_pool(client: SupersetClient, pool_size: int, rng: rand
     if not candidates:
         raise RuntimeError("No source charts available for templating")
 
-    selected = candidates if len(candidates) <= pool_size else rng.sample(candidates, pool_size)
+    selected = (
+        candidates
+        if len(candidates) <= pool_size
+        else rng.sample(candidates, pool_size)
+    )
     templates: List[Dict] = []
 
     for row in selected:
@@ -146,7 +219,9 @@ def _build_chart_template_pool(client: SupersetClient, pool_size: int, rng: rand
         detail = _extract_result_payload(detail_payload)
 
         datasource_id = detail.get("datasource_id")
-        datasource_type = detail.get("datasource_type") or row.get("datasource_type") or "table"
+        datasource_type = (
+            detail.get("datasource_type") or row.get("datasource_type") or "table"
+        )
         if datasource_id is None:
             continue
 
@@ -172,6 +247,8 @@ def _build_chart_template_pool(client: SupersetClient, pool_size: int, rng: rand
         raise RuntimeError("Could not build templates with datasource metadata")
 
     return templates
+
+
 # [/DEF:_build_chart_template_pool:Function]
 
 
@@ -195,23 +272,33 @@ def seed_superset_load_data(args: argparse.Namespace) -> Dict:
         client = SupersetClient(env)
         client.authenticate()
         clients[env_id] = client
-        templates_by_env[env_id] = _build_chart_template_pool(client, args.template_pool_size, rng)
-        logger.info(f"[REASON] Environment {env_id}: loaded {len(templates_by_env[env_id])} chart templates")
+        templates_by_env[env_id] = _build_chart_template_pool(
+            client, args.template_pool_size, rng
+        )
+        logger.info(
+            f"[REASON] Environment {env_id}: loaded {len(templates_by_env[env_id])} chart templates"
+        )
 
     errors = 0
     env_ids = list(env_map.keys())
 
     for idx in range(args.dashboards):
-        env_id = env_ids[idx % len(env_ids)] if idx < len(env_ids) else rng.choice(env_ids)
+        env_id = (
+            env_ids[idx % len(env_ids)] if idx < len(env_ids) else rng.choice(env_ids)
+        )
         dashboard_title = _generate_unique_name("lt_dash", used_dashboard_names, rng)
 
         if args.dry_run:
-            logger.info(f"[REFLECT] Dry-run dashboard create: env={env_id}, title={dashboard_title}")
+            logger.info(
+                f"[REFLECT] Dry-run dashboard create: env={env_id}, title={dashboard_title}"
+            )
             continue
 
         try:
             payload = {"dashboard_title": dashboard_title, "published": False}
-            created = clients[env_id].network.request("POST", "/dashboard/", data=json.dumps(payload))
+            created = clients[env_id].network.request(
+                "POST", "/dashboard/", data=json.dumps(payload)
+            )
             dashboard_id = _extract_created_id(created)
             if dashboard_id is None:
                 raise RuntimeError(f"Dashboard create response missing id: {created}")
@@ -220,7 +307,9 @@ def seed_superset_load_data(args: argparse.Namespace) -> Dict:
             errors += 1
             logger.error(f"[EXPLORE] Failed creating dashboard in {env_id}: {exc}")
             if errors >= args.max_errors:
-                raise RuntimeError(f"Stopping due to max errors reached ({errors})") from exc
+                raise RuntimeError(
+                    f"Stopping due to max errors reached ({errors})"
+                ) from exc
 
     if args.dry_run:
         return {
@@ -232,7 +321,9 @@ def seed_superset_load_data(args: argparse.Namespace) -> Dict:
 
     for env_id in env_ids:
         if not created_dashboards[env_id]:
-            raise RuntimeError(f"No dashboards created in environment {env_id}; cannot bind charts")
+            raise RuntimeError(
+                f"No dashboards created in environment {env_id}; cannot bind charts"
+            )
 
     for index in range(args.charts):
         env_id = rng.choice(env_ids)
@@ -255,7 +346,9 @@ def seed_superset_load_data(args: argparse.Namespace) -> Dict:
             payload["query_context"] = template["query_context"]
 
         try:
-            created = client.network.request("POST", "/chart/", data=json.dumps(payload))
+            created = client.network.request(
+                "POST", "/chart/", data=json.dumps(payload)
+            )
             chart_id = _extract_created_id(created)
             if chart_id is None:
                 raise RuntimeError(f"Chart create response missing id: {created}")
@@ -267,7 +360,9 @@ def seed_superset_load_data(args: argparse.Namespace) -> Dict:
             errors += 1
             logger.error(f"[EXPLORE] Failed creating chart in {env_id}: {exc}")
             if errors >= args.max_errors:
-                raise RuntimeError(f"Stopping due to max errors reached ({errors})") from exc
+                raise RuntimeError(
+                    f"Stopping due to max errors reached ({errors})"
+                ) from exc
 
     return {
         "dry_run": False,
@@ -277,6 +372,8 @@ def seed_superset_load_data(args: argparse.Namespace) -> Dict:
         "total_dashboards": sum(len(ids) for ids in created_dashboards.values()),
         "total_charts": sum(len(ids) for ids in created_charts.values()),
     }
+
+
 # [/DEF:seed_superset_load_data:Function]
 
 
@@ -288,7 +385,9 @@ def main() -> None:
     with belief_scope("seed_superset_load_test.main"):
         args = _parse_args()
         result = seed_superset_load_data(args)
-        logger.info(f"[COHERENCE:OK] Result summary: {json.dumps(result, ensure_ascii=True)}")
+        logger.info(
+            f"[COHERENCE:OK] Result summary: {json.dumps(result, ensure_ascii=True)}"
+        )
 
 
 # [/DEF:main:Function]
@@ -297,4 +396,4 @@ def main() -> None:
 if __name__ == "__main__":
     main()
 
-# [/DEF:backend.src.scripts.seed_superset_load_test:Module]
+# [/DEF:SeedSupersetLoadTestScript:Module]
diff --git a/backend/src/services/auth_service.py b/backend/src/services/auth_service.py
index f41367b5..22567b64 100644
--- a/backend/src/services/auth_service.py
+++ b/backend/src/services/auth_service.py
@@ -3,11 +3,11 @@
 # @SEMANTICS: auth, service, business-logic, login, jwt, adfs, jit-provisioning
 # @PURPOSE:   Orchestrates credential authentication and ADFS JIT user provisioning.
 # @LAYER:     Domain
-# @RELATION:  DEPENDS_ON -> [AuthRepository]
-# @RELATION:  DEPENDS_ON -> [verify_password]
-# @RELATION:  DEPENDS_ON -> [create_access_token]
-# @RELATION:  DEPENDS_ON -> [User]
-# @RELATION:  DEPENDS_ON -> [Role]
+# @RELATION: [DEPENDS_ON] ->[AuthRepository]
+# @RELATION: [DEPENDS_ON] ->[verify_password]
+# @RELATION: [DEPENDS_ON] ->[create_access_token]
+# @RELATION: [DEPENDS_ON] ->[User]
+# @RELATION: [DEPENDS_ON] ->[Role]
 # @INVARIANT: Authentication succeeds only for active users with valid credentials; issued sessions encode subject and scopes from assigned roles.
 # @PRE:       Core auth models and security utilities available.
 # @POST:      User identity verified and session tokens issued according to role scopes.
@@ -29,6 +29,9 @@ from ..core.logger import belief_scope
 # [DEF:AuthService:Class]
 # @COMPLEXITY: 3
 # @PURPOSE: Provides high-level authentication services.
+# @RELATION: [DEPENDS_ON] ->[AuthRepository]
+# @RELATION: [DEPENDS_ON] ->[User]
+# @RELATION: [DEPENDS_ON] ->[Role]
 class AuthService:
     # [DEF:AuthService_init:Function]
     # @COMPLEXITY: 1
@@ -51,6 +54,9 @@ class AuthService:
     # @POST: Returns User only when user exists, is active, and password hash verification succeeds; otherwise returns None.
     # @SIDE_EFFECT: Persists last_login update for successful authentications via repository.
     # @DATA_CONTRACT: Input(str username, str password) -> Output(User | None)
+    # @RELATION: [DEPENDS_ON] ->[AuthRepository]
+    # @RELATION: [CALLS] ->[verify_password]
+    # @RELATION: [DEPENDS_ON] ->[User]
     # @PARAM: username (str) - The username.
     # @PARAM: password (str) - The plain password.
     # @RETURN: Optional[User] - The authenticated user or None.
@@ -79,6 +85,9 @@ class AuthService:
     # @POST: Returns session dict with non-empty access_token and token_type='bearer'.
     # @SIDE_EFFECT: Generates signed JWT via auth JWT provider.
     # @DATA_CONTRACT: Input(User) -> Output(Dict[str, str]{access_token, token_type})
+    # @RELATION: [CALLS] ->[create_access_token]
+    # @RELATION: [DEPENDS_ON] ->[User]
+    # @RELATION: [DEPENDS_ON] ->[Role]
     # @PARAM: user (User) - The authenticated user.
     # @RETURN: Dict[str, str] - Session data.
     def create_session(self, user: User) -> Dict[str, str]:
@@ -98,6 +107,9 @@ class AuthService:
     # @POST: Returns persisted user entity with roles synchronized to mapped AD groups and refreshed state.
     # @SIDE_EFFECT: May insert new User, mutate user.roles, commit transaction, and refresh ORM state.
     # @DATA_CONTRACT: Input(Dict[str, Any]{upn|email, email, groups[]}) -> Output(User persisted)
+    # @RELATION: [DEPENDS_ON] ->[AuthRepository]
+    # @RELATION: [DEPENDS_ON] ->[User]
+    # @RELATION: [DEPENDS_ON] ->[Role]
     # @PARAM: user_info (Dict[str, Any]) - Claims from ADFS token.
     # @RETURN: User - The provisioned user.
     def provision_adfs_user(self, user_info: Dict[str, Any]) -> User:
diff --git a/backend/src/services/clean_release/__init__.py b/backend/src/services/clean_release/__init__.py
index 19c14da0..70d02cfb 100644
--- a/backend/src/services/clean_release/__init__.py
+++ b/backend/src/services/clean_release/__init__.py
@@ -1,7 +1,11 @@
-# [DEF:clean_release:Module]
+# [DEF:CleanReleaseContracts:Module]
 # @COMPLEXITY: 3
-# @PURPOSE: Redesigned clean release compliance subsystem.
+# @PURPOSE: Publish the canonical semantic root for the clean-release backend service cluster.
 # @LAYER: Domain
+# @RELATION: [DEPENDS_ON] ->[ComplianceOrchestrator]
+# @RELATION: [DEPENDS_ON] ->[ManifestBuilder]
+# @RELATION: [DEPENDS_ON] ->[PolicyEngine]
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
 
 from ...core.logger import logger
 
@@ -13,4 +17,4 @@ __all__ = [
     "logger",
 ]
 
-# [/DEF:clean_release:Module]
\ No newline at end of file
+# [/DEF:CleanReleaseContracts:Module]
diff --git a/backend/src/services/clean_release/__tests__/test_audit_service.py b/backend/src/services/clean_release/__tests__/test_audit_service.py
index 89dded35..2c8abcfe 100644
--- a/backend/src/services/clean_release/__tests__/test_audit_service.py
+++ b/backend/src/services/clean_release/__tests__/test_audit_service.py
@@ -1,5 +1,5 @@
 # [DEF:TestAuditService:Module]
-# @RELATION: BELONGS_TO -> SrcRoot
+# @RELATION: [DEPENDS_ON] ->[AuditService]
 # @COMPLEXITY: 3
 # @SEMANTICS: tests, clean-release, audit, logging
 # @PURPOSE: Validate audit hooks emit expected log patterns for clean release lifecycle.
diff --git a/backend/src/services/clean_release/__tests__/test_compliance_orchestrator.py b/backend/src/services/clean_release/__tests__/test_compliance_orchestrator.py
index 70b203cb..180d369b 100644
--- a/backend/src/services/clean_release/__tests__/test_compliance_orchestrator.py
+++ b/backend/src/services/clean_release/__tests__/test_compliance_orchestrator.py
@@ -1,5 +1,5 @@
 # [DEF:TestComplianceOrchestrator:Module]
-# @RELATION: BELONGS_TO -> SrcRoot
+# @RELATION: [DEPENDS_ON] ->[ComplianceOrchestrator]
 # @COMPLEXITY: 3
 # @SEMANTICS: tests, clean-release, orchestrator, stage-state-machine
 # @PURPOSE: Validate compliance orchestrator stage transitions and final status derivation.
@@ -16,7 +16,9 @@ from src.models.clean_release import (
     CheckStageResult,
     CheckStageStatus,
 )
-from src.services.clean_release.compliance_orchestrator import CleanComplianceOrchestrator
+from src.services.clean_release.compliance_orchestrator import (
+    CleanComplianceOrchestrator,
+)
 from src.services.clean_release.report_builder import ComplianceReportBuilder
 from src.services.clean_release.repository import CleanReleaseRepository
 
@@ -37,15 +39,33 @@ def test_orchestrator_stage_failure_blocks_release():
     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.FAIL, details="external"),
-            CheckStageResult(stage=CheckStageName.MANIFEST_CONSISTENCY, status=CheckStageStatus.PASS, details="ok"),
+            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.FAIL,
+                details="external",
+            ),
+            CheckStageResult(
+                stage=CheckStageName.MANIFEST_CONSISTENCY,
+                status=CheckStageStatus.PASS,
+                details="ok",
+            ),
         ],
     )
     run = orchestrator.finalize_run(run)
 
     assert run.final_status == CheckFinalStatus.BLOCKED
+
+
 # [/DEF:test_orchestrator_stage_failure_blocks_release:Function]
 
 
@@ -65,15 +85,33 @@ def test_orchestrator_compliant_candidate():
     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"),
+            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]
 
 
@@ -87,11 +125,19 @@ def test_orchestrator_missing_stage_result():
     run = orchestrator.start_check_run("cand-1", "pol-1", "tester", "tui")
     run = orchestrator.execute_stages(
         run,
-        forced_results=[CheckStageResult(stage=CheckStageName.DATA_PURITY, status=CheckStageStatus.PASS, details="ok")],
+        forced_results=[
+            CheckStageResult(
+                stage=CheckStageName.DATA_PURITY,
+                status=CheckStageStatus.PASS,
+                details="ok",
+            )
+        ],
     )
     run = orchestrator.finalize_run(run)
 
     assert run.final_status == CheckFinalStatus.FAILED
+
+
 # [/DEF:test_orchestrator_missing_stage_result:Function]
 
 
@@ -106,11 +152,17 @@ def test_orchestrator_report_generation_error():
     run = orchestrator.finalize_run(run)
     assert run.final_status == CheckFinalStatus.FAILED
 
-    with patch.object(ComplianceReportBuilder, "build_report_payload", side_effect=ValueError("Report error")):
+    with patch.object(
+        ComplianceReportBuilder,
+        "build_report_payload",
+        side_effect=ValueError("Report error"),
+    ):
         builder = ComplianceReportBuilder(repository)
         with pytest.raises(ValueError, match="Report error"):
             builder.build_report_payload(run, [])
 
     assert run.final_status == CheckFinalStatus.FAILED
+
+
 # [/DEF:test_orchestrator_report_generation_error:Function]
 # [/DEF:TestComplianceOrchestrator:Module]
diff --git a/backend/src/services/clean_release/__tests__/test_manifest_builder.py b/backend/src/services/clean_release/__tests__/test_manifest_builder.py
index ba2311fc..38b85b0c 100644
--- a/backend/src/services/clean_release/__tests__/test_manifest_builder.py
+++ b/backend/src/services/clean_release/__tests__/test_manifest_builder.py
@@ -3,7 +3,7 @@
 # @SEMANTICS: tests, clean-release, manifest, deterministic
 # @PURPOSE: Validate deterministic manifest generation behavior for US1.
 # @LAYER: Domain
-# @RELATION: VERIFIES -> backend.src.services.clean_release.manifest_builder
+# @RELATION: [DEPENDS_ON] ->[ManifestBuilder]
 # @INVARIANT: Same input artifacts produce identical deterministic hash.
 
 from src.services.clean_release.manifest_builder import build_distribution_manifest
@@ -16,8 +16,18 @@ from src.services.clean_release.manifest_builder import build_distribution_manif
 # @POST: Hash and summary remain identical.
 def test_manifest_deterministic_hash_for_same_input():
     artifacts = [
-        {"path": "a.yaml", "category": "system-init", "classification": "required-system", "reason": "required"},
-        {"path": "b.yaml", "category": "test-data", "classification": "excluded-prohibited", "reason": "prohibited"},
+        {
+            "path": "a.yaml",
+            "category": "system-init",
+            "classification": "required-system",
+            "reason": "required",
+        },
+        {
+            "path": "b.yaml",
+            "category": "test-data",
+            "classification": "excluded-prohibited",
+            "reason": "prohibited",
+        },
     ]
 
     manifest1 = build_distribution_manifest(
@@ -38,5 +48,7 @@ def test_manifest_deterministic_hash_for_same_input():
     assert manifest1.deterministic_hash == manifest2.deterministic_hash
     assert manifest1.summary.included_count == manifest2.summary.included_count
     assert manifest1.summary.excluded_count == manifest2.summary.excluded_count
+
+
 # [/DEF:test_manifest_deterministic_hash_for_same_input:Function]
-# [/DEF:TestManifestBuilder:Module]
\ No newline at end of file
+# [/DEF:TestManifestBuilder:Module]
diff --git a/backend/src/services/clean_release/__tests__/test_policy_engine.py b/backend/src/services/clean_release/__tests__/test_policy_engine.py
index 374d174a..1544fb1d 100644
--- a/backend/src/services/clean_release/__tests__/test_policy_engine.py
+++ b/backend/src/services/clean_release/__tests__/test_policy_engine.py
@@ -1,19 +1,20 @@
-# [DEF:__tests__/test_policy_engine:Module]
-# @RELATION: VERIFIES -> ../policy_engine.py
+# [DEF:TestPolicyEngine:Module]
+# @RELATION: [DEPENDS_ON] ->[PolicyEngine]
 # @PURPOSE: Contract testing for CleanPolicyEngine
-# [/DEF:__tests__/test_policy_engine:Module]
+# [/DEF:TestPolicyEngine:Module]
 
 import pytest
 from datetime import datetime
 from src.models.clean_release import (
-    CleanProfilePolicy, 
-    ResourceSourceRegistry, 
-    ResourceSourceEntry, 
-    ProfileType, 
-    RegistryStatus
+    CleanProfilePolicy,
+    ResourceSourceRegistry,
+    ResourceSourceEntry,
+    ProfileType,
+    RegistryStatus,
 )
 from src.services.clean_release.policy_engine import CleanPolicyEngine
 
+
 # @TEST_FIXTURE: policy_enterprise_clean
 @pytest.fixture
 def enterprise_clean_setup():
@@ -25,23 +26,30 @@ def enterprise_clean_setup():
         required_system_categories=["core"],
         internal_source_registry_ref="REG-1",
         effective_from=datetime.now(),
-        profile=ProfileType.ENTERPRISE_CLEAN
+        profile=ProfileType.ENTERPRISE_CLEAN,
     )
     registry = ResourceSourceRegistry(
         registry_id="REG-1",
         name="Internal Registry",
         entries=[
-            ResourceSourceEntry(source_id="S1", host="internal.com", protocol="https", purpose="p1", enabled=True)
+            ResourceSourceEntry(
+                source_id="S1",
+                host="internal.com",
+                protocol="https",
+                purpose="p1",
+                enabled=True,
+            )
         ],
         updated_at=datetime.now(),
         updated_by="admin",
-        status=RegistryStatus.ACTIVE
+        status=RegistryStatus.ACTIVE,
     )
     return policy, registry
 
+
 # @TEST_SCENARIO: policy_valid
 # [DEF:test_policy_valid:Function]
-# @RELATION: BINDS_TO -> __tests__/test_policy_engine
+# @RELATION: BINDS_TO -> TestPolicyEngine
 def test_policy_valid(enterprise_clean_setup):
     policy, registry = enterprise_clean_setup
     engine = CleanPolicyEngine(policy, registry)
@@ -49,11 +57,13 @@ def test_policy_valid(enterprise_clean_setup):
     assert result.ok is True
     assert not result.blocking_reasons
 
+
 # @TEST_EDGE: missing_registry_ref
 # [/DEF:test_policy_valid:Function]
 
+
 # [DEF:test_missing_registry_ref:Function]
-# @RELATION: BINDS_TO -> __tests__/test_policy_engine
+# @RELATION: BINDS_TO -> TestPolicyEngine
 def test_missing_registry_ref(enterprise_clean_setup):
     policy, registry = enterprise_clean_setup
     policy.internal_source_registry_ref = "  "
@@ -62,76 +72,95 @@ def test_missing_registry_ref(enterprise_clean_setup):
     assert result.ok is False
     assert "Policy missing internal_source_registry_ref" in result.blocking_reasons
 
+
 # @TEST_EDGE: conflicting_registry
 # [/DEF:test_missing_registry_ref:Function]
 
+
 # [DEF:test_conflicting_registry:Function]
-# @RELATION: BINDS_TO -> __tests__/test_policy_engine
+# @RELATION: BINDS_TO -> TestPolicyEngine
 def test_conflicting_registry(enterprise_clean_setup):
     policy, registry = enterprise_clean_setup
     registry.registry_id = "WRONG-REG"
     engine = CleanPolicyEngine(policy, registry)
     result = engine.validate_policy()
     assert result.ok is False
-    assert "Policy registry ref does not match provided registry" in result.blocking_reasons
+    assert (
+        "Policy registry ref does not match provided registry"
+        in result.blocking_reasons
+    )
+
 
 # @TEST_INVARIANT: deterministic_classification
 # [/DEF:test_conflicting_registry:Function]
 
+
 # [DEF:test_classify_artifact:Function]
-# @RELATION: BINDS_TO -> __tests__/test_policy_engine
+# @RELATION: BINDS_TO -> TestPolicyEngine
 def test_classify_artifact(enterprise_clean_setup):
     policy, registry = enterprise_clean_setup
     engine = CleanPolicyEngine(policy, registry)
-    
+
     # Required
-    assert engine.classify_artifact({"category": "core", "path": "p1"}) == "required-system"
+    assert (
+        engine.classify_artifact({"category": "core", "path": "p1"})
+        == "required-system"
+    )
     # Prohibited
-    assert engine.classify_artifact({"category": "demo", "path": "p2"}) == "excluded-prohibited"
+    assert (
+        engine.classify_artifact({"category": "demo", "path": "p2"})
+        == "excluded-prohibited"
+    )
     # Allowed
     assert engine.classify_artifact({"category": "others", "path": "p3"}) == "allowed"
 
+
 # @TEST_EDGE: external_endpoint
 # [/DEF:test_classify_artifact:Function]
 
+
 # [DEF:test_validate_resource_source:Function]
-# @RELATION: BINDS_TO -> __tests__/test_policy_engine
+# @RELATION: BINDS_TO -> TestPolicyEngine
 def test_validate_resource_source(enterprise_clean_setup):
     policy, registry = enterprise_clean_setup
     engine = CleanPolicyEngine(policy, registry)
-    
+
     # Internal (OK)
     res_ok = engine.validate_resource_source("internal.com")
     assert res_ok.ok is True
-    
+
     # External (Blocked)
     res_fail = engine.validate_resource_source("external.evil")
     assert res_fail.ok is False
     assert res_fail.violation["category"] == "external-source"
     assert res_fail.violation["blocked_release"] is True
 
+
 # [/DEF:test_validate_resource_source:Function]
 
+
 # [DEF:test_evaluate_candidate:Function]
-# @RELATION: BINDS_TO -> __tests__/test_policy_engine
+# @RELATION: BINDS_TO -> TestPolicyEngine
 def test_evaluate_candidate(enterprise_clean_setup):
     policy, registry = enterprise_clean_setup
     engine = CleanPolicyEngine(policy, registry)
-    
+
     artifacts = [
         {"path": "core.js", "category": "core"},
-        {"path": "demo.sql", "category": "demo"}
+        {"path": "demo.sql", "category": "demo"},
     ]
     sources = ["internal.com", "google.com"]
-    
+
     classified, violations = engine.evaluate_candidate(artifacts, sources)
-    
+
     assert len(classified) == 2
     assert classified[0]["classification"] == "required-system"
     assert classified[1]["classification"] == "excluded-prohibited"
-    
+
     # 1 violation for demo artifact + 1 for google.com source
     assert len(violations) == 2
     assert violations[0]["category"] == "data-purity"
     assert violations[1]["category"] == "external-source"
+
+
 # [/DEF:test_evaluate_candidate:Function]
diff --git a/backend/src/services/clean_release/__tests__/test_preparation_service.py b/backend/src/services/clean_release/__tests__/test_preparation_service.py
index f5b08678..8b7423ac 100644
--- a/backend/src/services/clean_release/__tests__/test_preparation_service.py
+++ b/backend/src/services/clean_release/__tests__/test_preparation_service.py
@@ -3,7 +3,7 @@
 # @SEMANTICS: tests, clean-release, preparation, flow
 # @PURPOSE: Validate release candidate preparation flow, including policy evaluation and manifest persisting.
 # @LAYER: Domain
-# @RELATION: [DEPENDS_ON] ->[backend.src.services.clean_release.preparation_service:Module]
+# @RELATION: [DEPENDS_ON] ->[PreparationService]
 # @INVARIANT: Candidate preparation always persists manifest and candidate status deterministically.
 
 import pytest
diff --git a/backend/src/services/clean_release/__tests__/test_report_builder.py b/backend/src/services/clean_release/__tests__/test_report_builder.py
index cf0ceb53..a0c4b10f 100644
--- a/backend/src/services/clean_release/__tests__/test_report_builder.py
+++ b/backend/src/services/clean_release/__tests__/test_report_builder.py
@@ -1,5 +1,5 @@
 # [DEF:TestReportBuilder:Module]
-# @RELATION: BELONGS_TO -> SrcRoot
+# @RELATION: [DEPENDS_ON] ->[ReportBuilder]
 # @COMPLEXITY: 3
 # @SEMANTICS: tests, clean-release, report-builder, counters
 # @PURPOSE: Validate compliance report builder counter integrity and blocked-run constraints.
@@ -37,6 +37,8 @@ def _terminal_run(status: CheckFinalStatus) -> ComplianceCheckRun:
         execution_mode=ExecutionMode.TUI,
         checks=[],
     )
+
+
 # [/DEF:_terminal_run:Function]
 
 
@@ -54,6 +56,8 @@ def _blocking_violation() -> ComplianceViolation:
         blocked_release=True,
         detected_at=datetime.now(timezone.utc),
     )
+
+
 # [/DEF:_blocking_violation:Function]
 
 
@@ -66,6 +70,8 @@ def test_report_builder_blocked_requires_blocking_violations():
 
     with pytest.raises(ValueError):
         builder.build_report_payload(run, [])
+
+
 # [/DEF:test_report_builder_blocked_requires_blocking_violations:Function]
 
 
@@ -79,14 +85,16 @@ def test_report_builder_blocked_with_two_violations():
     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]
 
 
@@ -100,6 +108,8 @@ def test_report_builder_counter_consistency():
 
     assert report.violations_count == 1
     assert report.blocking_violations_count == 1
+
+
 # [/DEF:test_report_builder_counter_consistency:Function]
 
 
@@ -114,5 +124,7 @@ def test_missing_operator_summary():
         builder.build_report_payload(run, [])
 
     assert "Cannot build report for non-terminal run" in str(exc.value)
+
+
 # [/DEF:test_missing_operator_summary:Function]
 # [/DEF:TestReportBuilder:Module]
diff --git a/backend/src/services/clean_release/__tests__/test_source_isolation.py b/backend/src/services/clean_release/__tests__/test_source_isolation.py
index 9e6f2669..06b69759 100644
--- a/backend/src/services/clean_release/__tests__/test_source_isolation.py
+++ b/backend/src/services/clean_release/__tests__/test_source_isolation.py
@@ -1,5 +1,5 @@
 # [DEF:TestSourceIsolation:Module]
-# @RELATION: BELONGS_TO -> SrcRoot
+# @RELATION: [DEPENDS_ON] ->[SourceIsolation]
 # @COMPLEXITY: 3
 # @SEMANTICS: tests, clean-release, source-isolation, internal-only
 # @PURPOSE: Verify internal source registry validation behavior.
diff --git a/backend/src/services/clean_release/__tests__/test_stages.py b/backend/src/services/clean_release/__tests__/test_stages.py
index 6b5fbc46..0f47e329 100644
--- a/backend/src/services/clean_release/__tests__/test_stages.py
+++ b/backend/src/services/clean_release/__tests__/test_stages.py
@@ -1,5 +1,5 @@
 # [DEF:TestStages:Module]
-# @RELATION: BELONGS_TO -> SrcRoot
+# @RELATION: [DEPENDS_ON] ->[ComplianceStages]
 # @COMPLEXITY: 3
 # @SEMANTICS: tests, clean-release, compliance, stages
 # @PURPOSE: Validate final status derivation logic from stage results.
diff --git a/backend/src/services/clean_release/approval_service.py b/backend/src/services/clean_release/approval_service.py
index ac7f6c58..68c2ab45 100644
--- a/backend/src/services/clean_release/approval_service.py
+++ b/backend/src/services/clean_release/approval_service.py
@@ -1,11 +1,11 @@
-# [DEF:approval_service:Module]
+# [DEF:ApprovalService:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, approval, decision, lifecycle, gate
 # @PURPOSE: Enforce approval/rejection gates over immutable compliance reports.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.audit_service
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
+# @RELATION: [DEPENDS_ON] ->[AuditService]
 # @INVARIANT: Approval is allowed only for PASSED report bound to candidate; decisions are append-only.
 
 from __future__ import annotations
@@ -26,12 +26,16 @@ from .repository import CleanReleaseRepository
 # @PURPOSE: Provide append-only in-memory storage for approval decisions.
 # @PRE: repository is initialized.
 # @POST: Returns mutable decision list attached to repository.
-def _get_or_init_decisions_store(repository: CleanReleaseRepository) -> List[ApprovalDecision]:
+def _get_or_init_decisions_store(
+    repository: CleanReleaseRepository,
+) -> List[ApprovalDecision]:
     decisions = getattr(repository, "approval_decisions", None)
     if decisions is None:
         decisions = []
         setattr(repository, "approval_decisions", decisions)
     return decisions
+
+
 # [/DEF:_get_or_init_decisions_store:Function]
 
 
@@ -39,12 +43,20 @@ def _get_or_init_decisions_store(repository: CleanReleaseRepository) -> List[App
 # @PURPOSE: Resolve latest approval decision for candidate from append-only store.
 # @PRE: candidate_id is non-empty.
 # @POST: Returns latest ApprovalDecision or None.
-def _latest_decision_for_candidate(repository: CleanReleaseRepository, candidate_id: str) -> ApprovalDecision | None:
+def _latest_decision_for_candidate(
+    repository: CleanReleaseRepository, candidate_id: str
+) -> ApprovalDecision | None:
     decisions = _get_or_init_decisions_store(repository)
     scoped = [item for item in decisions if item.candidate_id == candidate_id]
     if not scoped:
         return None
-    return sorted(scoped, key=lambda item: item.decided_at or datetime.min.replace(tzinfo=timezone.utc), reverse=True)[0]
+    return sorted(
+        scoped,
+        key=lambda item: item.decided_at or datetime.min.replace(tzinfo=timezone.utc),
+        reverse=True,
+    )[0]
+
+
 # [/DEF:_latest_decision_for_candidate:Function]
 
 
@@ -70,6 +82,8 @@ def _resolve_candidate_and_report(
         raise ApprovalGateError("report belongs to another candidate")
 
     return candidate, report
+
+
 # [/DEF:_resolve_candidate_and_report:Function]
 
 
@@ -86,7 +100,9 @@ def approve_candidate(
     comment: str | None = None,
 ) -> ApprovalDecision:
     with belief_scope("approval_service.approve_candidate"):
-        logger.reason(f"[REASON] Evaluating approve gate candidate_id={candidate_id} report_id={report_id}")
+        logger.reason(
+            f"[REASON] Evaluating approve gate candidate_id={candidate_id} report_id={report_id}"
+        )
 
         if not decided_by or not decided_by.strip():
             raise ApprovalGateError("decided_by must be non-empty")
@@ -101,7 +117,10 @@ def approve_candidate(
             raise ApprovalGateError("approve requires PASSED compliance report")
 
         latest = _latest_decision_for_candidate(repository, candidate_id)
-        if latest is not None and latest.decision == ApprovalDecisionType.APPROVED.value:
+        if (
+            latest is not None
+            and latest.decision == ApprovalDecisionType.APPROVED.value
+        ):
             raise ApprovalGateError("candidate is already approved")
 
         if candidate.status == CandidateStatus.APPROVED.value:
@@ -117,7 +136,9 @@ def approve_candidate(
         except ApprovalGateError:
             raise
         except Exception as exc:  # noqa: BLE001
-            logger.explore(f"[EXPLORE] Candidate transition to APPROVED failed candidate_id={candidate_id}: {exc}")
+            logger.explore(
+                f"[EXPLORE] Candidate transition to APPROVED failed candidate_id={candidate_id}: {exc}"
+            )
             raise ApprovalGateError(str(exc)) from exc
 
         decision = ApprovalDecision(
@@ -130,9 +151,15 @@ def approve_candidate(
             comment=comment,
         )
         _get_or_init_decisions_store(repository).append(decision)
-        audit_preparation(candidate_id, "APPROVED", repository=repository, actor=decided_by)
-        logger.reflect(f"[REFLECT] Approval persisted candidate_id={candidate_id} decision_id={decision.id}")
+        audit_preparation(
+            candidate_id, "APPROVED", repository=repository, actor=decided_by
+        )
+        logger.reflect(
+            f"[REFLECT] Approval persisted candidate_id={candidate_id} decision_id={decision.id}"
+        )
         return decision
+
+
 # [/DEF:approve_candidate:Function]
 
 
@@ -149,7 +176,9 @@ def reject_candidate(
     comment: str | None = None,
 ) -> ApprovalDecision:
     with belief_scope("approval_service.reject_candidate"):
-        logger.reason(f"[REASON] Evaluating reject decision candidate_id={candidate_id} report_id={report_id}")
+        logger.reason(
+            f"[REASON] Evaluating reject decision candidate_id={candidate_id} report_id={report_id}"
+        )
 
         if not decided_by or not decided_by.strip():
             raise ApprovalGateError("decided_by must be non-empty")
@@ -170,9 +199,15 @@ def reject_candidate(
             comment=comment,
         )
         _get_or_init_decisions_store(repository).append(decision)
-        audit_preparation(candidate_id, "REJECTED", repository=repository, actor=decided_by)
-        logger.reflect(f"[REFLECT] Rejection persisted candidate_id={candidate_id} decision_id={decision.id}")
+        audit_preparation(
+            candidate_id, "REJECTED", repository=repository, actor=decided_by
+        )
+        logger.reflect(
+            f"[REFLECT] Rejection persisted candidate_id={candidate_id} decision_id={decision.id}"
+        )
         return decision
+
+
 # [/DEF:reject_candidate:Function]
 
-# [/DEF:backend.src.services.clean_release.approval_service:Module]
\ No newline at end of file
+# [/DEF:backend.src.services.clean_release.approval_service:Module]
diff --git a/backend/src/services/clean_release/artifact_catalog_loader.py b/backend/src/services/clean_release/artifact_catalog_loader.py
index ecbc33e3..e6eddc64 100644
--- a/backend/src/services/clean_release/artifact_catalog_loader.py
+++ b/backend/src/services/clean_release/artifact_catalog_loader.py
@@ -1,9 +1,9 @@
-# [DEF:artifact_catalog_loader:Module]
+# [DEF:ArtifactCatalogLoader:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, artifacts, bootstrap, json, tui
 # @PURPOSE: Load bootstrap artifact catalogs for clean release real-mode flows.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release.CandidateArtifact
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
 # @INVARIANT: Artifact catalog must produce deterministic CandidateArtifact entries with required identity and checksum fields.
 
 from __future__ import annotations
@@ -29,7 +29,9 @@ def load_bootstrap_artifacts(path: str, candidate_id: str) -> List[CandidateArti
     payload = json.loads(catalog_path.read_text(encoding="utf-8"))
     raw_artifacts = payload.get("artifacts") if isinstance(payload, dict) else payload
     if not isinstance(raw_artifacts, list):
-        raise ValueError("artifact catalog must be a list or an object with 'artifacts' list")
+        raise ValueError(
+            "artifact catalog must be a list or an object with 'artifacts' list"
+        )
 
     artifacts: List[CandidateArtifact] = []
     for index, raw_artifact in enumerate(raw_artifacts, start=1):
@@ -47,9 +49,18 @@ def load_bootstrap_artifacts(path: str, candidate_id: str) -> List[CandidateArti
         if not artifact_sha256:
             raise ValueError(f"artifact #{index} missing required field 'sha256'")
         if not isinstance(artifact_size, int) or artifact_size < 0:
-            raise ValueError(f"artifact #{index} field 'size' must be non-negative integer")
+            raise ValueError(
+                f"artifact #{index} field 'size' must be non-negative integer"
+            )
 
-        category = str(raw_artifact.get("detected_category") or raw_artifact.get("category") or "").strip() or None
+        category = (
+            str(
+                raw_artifact.get("detected_category")
+                or raw_artifact.get("category")
+                or ""
+            ).strip()
+            or None
+        )
         source_uri = str(raw_artifact.get("source_uri", "")).strip() or None
         source_host = str(raw_artifact.get("source_host", "")).strip() or None
         metadata_json = raw_artifact.get("metadata_json")
@@ -89,6 +100,8 @@ def load_bootstrap_artifacts(path: str, candidate_id: str) -> List[CandidateArti
         )
 
     return artifacts
+
+
 # [/DEF:load_bootstrap_artifacts:Function]
 
 # [/DEF:backend.src.services.clean_release.artifact_catalog_loader:Module]
diff --git a/backend/src/services/clean_release/audit_service.py b/backend/src/services/clean_release/audit_service.py
index 457df27b..3e5f2e61 100644
--- a/backend/src/services/clean_release/audit_service.py
+++ b/backend/src/services/clean_release/audit_service.py
@@ -1,9 +1,9 @@
-# [DEF:audit_service:Module]
+# [DEF:AuditService:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, audit, lifecycle, logging
 # @PURPOSE: Provide lightweight audit hooks for clean release preparation/check/report lifecycle.
 # @LAYER: Infra
-# @RELATION: DEPENDS_ON -> backend.src.core.logger
+# @RELATION: [DEPENDS_ON] ->[LoggerModule]
 # @INVARIANT: Audit hooks are append-only log actions.
 
 from __future__ import annotations
@@ -20,8 +20,12 @@ def _append_event(repository, payload: Dict[str, Any]) -> None:
         repository.append_audit_event(payload)
 
 
-def audit_preparation(candidate_id: str, status: str, repository=None, actor: str = "system") -> None:
-    logger.info(f"[REASON] clean-release preparation candidate={candidate_id} status={status}")
+def audit_preparation(
+    candidate_id: str, status: str, repository=None, actor: str = "system"
+) -> None:
+    logger.info(
+        f"[REASON] clean-release preparation candidate={candidate_id} status={status}"
+    )
     _append_event(
         repository,
         {
@@ -43,7 +47,9 @@ def audit_check_run(
     candidate_id: Optional[str] = None,
     actor: str = "system",
 ) -> None:
-    logger.info(f"[REFLECT] clean-release check_run={check_run_id} final_status={final_status}")
+    logger.info(
+        f"[REFLECT] clean-release check_run={check_run_id} final_status={final_status}"
+    )
     _append_event(
         repository,
         {
@@ -67,7 +73,9 @@ def audit_violation(
     candidate_id: Optional[str] = None,
     actor: str = "system",
 ) -> None:
-    logger.info(f"[EXPLORE] clean-release violation run_id={run_id} stage={stage_name} code={code}")
+    logger.info(
+        f"[EXPLORE] clean-release violation run_id={run_id} stage={stage_name} code={code}"
+    )
     _append_event(
         repository,
         {
@@ -91,7 +99,9 @@ def audit_report(
     run_id: Optional[str] = None,
     actor: str = "system",
 ) -> None:
-    logger.info(f"[EXPLORE] clean-release report_id={report_id} candidate={candidate_id}")
+    logger.info(
+        f"[EXPLORE] clean-release report_id={report_id} candidate={candidate_id}"
+    )
     _append_event(
         repository,
         {
@@ -104,4 +114,6 @@ def audit_report(
             "timestamp": datetime.now(timezone.utc).isoformat(),
         },
     )
-# [/DEF:backend.src.services.clean_release.audit_service:Module]
\ No newline at end of file
+
+
+# [/DEF:backend.src.services.clean_release.audit_service:Module]
diff --git a/backend/src/services/clean_release/compliance_execution_service.py b/backend/src/services/clean_release/compliance_execution_service.py
index f66a3cde..5d87c1dd 100644
--- a/backend/src/services/clean_release/compliance_execution_service.py
+++ b/backend/src/services/clean_release/compliance_execution_service.py
@@ -1,23 +1,29 @@
-# [DEF:compliance_execution_service:Module]
+# [DEF:ComplianceExecutionService:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, compliance, execution, stages, immutable-evidence
 # @PURPOSE: Create and execute compliance runs with trusted snapshots, deterministic stages, violations and immutable report persistence.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.policy_resolution_service
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.stages
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.report_builder
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
+# @RELATION: [DEPENDS_ON] ->[PolicyResolutionService]
+# @RELATION: [DEPENDS_ON] ->[ComplianceStages]
+# @RELATION: [DEPENDS_ON] ->[ReportBuilder]
 # @INVARIANT: A run binds to exactly one candidate/manifest/policy/registry snapshot set.
 
 from __future__ import annotations
 
 from dataclasses import dataclass
 from datetime import datetime, timezone
-from typing import Any, Iterable, List, Optional
+from typing import Any, Iterable, List, Optional, cast
 from uuid import uuid4
 
 from ...core.logger import belief_scope, logger
-from ...models.clean_release import ComplianceReport, ComplianceRun, ComplianceStageRun, ComplianceViolation, DistributionManifest
+from ...models.clean_release import (
+    ComplianceReport,
+    ComplianceRun,
+    ComplianceStageRun,
+    ComplianceViolation,
+    DistributionManifest,
+)
 from .audit_service import audit_check_run, audit_report, audit_violation
 from .enums import ComplianceDecision, RunStatus
 from .exceptions import ComplianceRunError, PolicyResolutionError
@@ -28,6 +34,9 @@ from .stages import build_default_stages, derive_final_status
 from .stages.base import ComplianceStage, ComplianceStageContext, build_stage_run_record
 
 
+belief_logger = cast(Any, logger)
+
+
 # [DEF:ComplianceExecutionResult:Class]
 # @PURPOSE: Return envelope for compliance execution with run/report and persisted stage artifacts.
 @dataclass
@@ -36,6 +45,8 @@ class ComplianceExecutionResult:
     report: Optional[ComplianceReport]
     stage_runs: List[ComplianceStageRun]
     violations: List[ComplianceViolation]
+
+
 # [/DEF:ComplianceExecutionResult:Class]
 
 
@@ -45,6 +56,7 @@ class ComplianceExecutionResult:
 # @POST: run state, stage records, violations and optional report are persisted consistently.
 class ComplianceExecutionService:
     TASK_PLUGIN_ID = "clean-release-compliance"
+
     def __init__(
         self,
         *,
@@ -61,28 +73,36 @@ class ComplianceExecutionService:
     # @PURPOSE: Resolve explicit manifest or fallback to latest candidate manifest.
     # @PRE: candidate exists.
     # @POST: Returns manifest snapshot or raises ComplianceRunError.
-    def _resolve_manifest(self, candidate_id: str, manifest_id: Optional[str]) -> DistributionManifest:
+    def _resolve_manifest(
+        self, candidate_id: str, manifest_id: Optional[str]
+    ) -> DistributionManifest:
         with belief_scope("ComplianceExecutionService._resolve_manifest"):
-            if manifest_id:
-                manifest = self.repository.get_manifest(manifest_id)
+            manifest_id_value = cast(Optional[str], manifest_id)
+            if manifest_id_value is not None and manifest_id_value != "":
+                manifest = self.repository.get_manifest(manifest_id_value)
                 if manifest is None:
-                    raise ComplianceRunError(f"manifest '{manifest_id}' not found")
-                if manifest.candidate_id != candidate_id:
+                    raise ComplianceRunError(
+                        f"manifest '{manifest_id_value}' not found"
+                    )
+                if str(getattr(manifest, "candidate_id")) != candidate_id:
                     raise ComplianceRunError("manifest does not belong to candidate")
                 return manifest
 
             manifests = self.repository.get_manifests_by_candidate(candidate_id)
             if not manifests:
                 raise ComplianceRunError(f"candidate '{candidate_id}' has no manifest")
-            return sorted(manifests, key=lambda item: item.manifest_version, reverse=True)[0]
+            return sorted(
+                manifests, key=lambda item: item.manifest_version, reverse=True
+            )[0]
+
     # [/DEF:_resolve_manifest:Function]
 
     # [DEF:_persist_stage_run:Function]
     # @PURPOSE: Persist stage run if repository supports stage records.
     # @POST: Stage run is persisted when adapter is available, otherwise no-op.
     def _persist_stage_run(self, stage_run: ComplianceStageRun) -> None:
-        if hasattr(self.repository, "save_stage_run"):
-            self.repository.save_stage_run(stage_run)
+        self.repository.save_stage_run(stage_run)
+
     # [/DEF:_persist_stage_run:Function]
 
     # [DEF:_persist_violations:Function]
@@ -91,6 +111,7 @@ class ComplianceExecutionService:
     def _persist_violations(self, violations: List[ComplianceViolation]) -> None:
         for violation in violations:
             self.repository.save_violation(violation)
+
     # [/DEF:_persist_violations:Function]
 
     # [DEF:execute_run:Function]
@@ -105,7 +126,9 @@ class ComplianceExecutionService:
         manifest_id: Optional[str] = None,
     ) -> ComplianceExecutionResult:
         with belief_scope("ComplianceExecutionService.execute_run"):
-            logger.reason(f"Starting compliance execution candidate_id={candidate_id}")
+            belief_logger.reason(
+                f"Starting compliance execution candidate_id={candidate_id}"
+            )
 
             candidate = self.repository.get_candidate(candidate_id)
             if candidate is None:
@@ -124,10 +147,10 @@ class ComplianceExecutionService:
             run = ComplianceRun(
                 id=f"run-{uuid4()}",
                 candidate_id=candidate_id,
-                manifest_id=manifest.id,
-                manifest_digest=manifest.manifest_digest,
-                policy_snapshot_id=policy_snapshot.id,
-                registry_snapshot_id=registry_snapshot.id,
+                manifest_id=str(getattr(manifest, "id")),
+                manifest_digest=str(getattr(manifest, "manifest_digest")),
+                policy_snapshot_id=str(getattr(policy_snapshot, "id")),
+                registry_snapshot_id=str(getattr(registry_snapshot, "id")),
                 requested_by=requested_by,
                 requested_at=datetime.now(timezone.utc),
                 started_at=datetime.now(timezone.utc),
@@ -154,7 +177,7 @@ class ComplianceExecutionService:
                     finished = datetime.now(timezone.utc)
 
                     stage_run = build_stage_run_record(
-                        run_id=run.id,
+                        run_id=str(getattr(run, "id")),
                         stage_name=stage.stage_name,
                         result=result,
                         started_at=started,
@@ -167,23 +190,27 @@ class ComplianceExecutionService:
                         self._persist_violations(result.violations)
                         violations.extend(result.violations)
 
-                run.final_status = derive_final_status(stage_runs).value
-                run.status = RunStatus.SUCCEEDED.value
-                run.finished_at = datetime.now(timezone.utc)
+                setattr(run, "final_status", derive_final_status(stage_runs).value)
+                setattr(run, "status", RunStatus.SUCCEEDED.value)
+                setattr(run, "finished_at", datetime.now(timezone.utc))
                 self.repository.save_check_run(run)
 
                 report = self.report_builder.build_report_payload(run, violations)
                 report = self.report_builder.persist_report(report)
-                run.report_id = report.id
+                setattr(run, "report_id", str(getattr(report, "id")))
                 self.repository.save_check_run(run)
-                logger.reflect(f"[REFLECT] Compliance run completed run_id={run.id} final_status={run.final_status}")
+                belief_logger.reflect(
+                    f"[REFLECT] Compliance run completed run_id={getattr(run, 'id')} final_status={getattr(run, 'final_status', None)}"
+                )
             except Exception as exc:  # noqa: BLE001
-                run.status = RunStatus.FAILED.value
-                run.final_status = ComplianceDecision.ERROR.value
-                run.failure_reason = str(exc)
-                run.finished_at = datetime.now(timezone.utc)
+                setattr(run, "status", RunStatus.FAILED.value)
+                setattr(run, "final_status", ComplianceDecision.ERROR.value)
+                setattr(run, "failure_reason", str(exc))
+                setattr(run, "finished_at", datetime.now(timezone.utc))
                 self.repository.save_check_run(run)
-                logger.explore(f"[EXPLORE] Compliance run failed run_id={run.id}: {exc}")
+                belief_logger.explore(
+                    f"[EXPLORE] Compliance run failed run_id={getattr(run, 'id')}: {exc}"
+                )
 
             return ComplianceExecutionResult(
                 run=run,
@@ -191,7 +218,10 @@ class ComplianceExecutionService:
                 stage_runs=stage_runs,
                 violations=violations,
             )
+
     # [/DEF:execute_run:Function]
+
+
 # [/DEF:ComplianceExecutionService:Class]
 
-# [/DEF:backend.src.services.clean_release.compliance_execution_service:Module]
\ No newline at end of file
+# [/DEF:ComplianceExecutionService:Module]
diff --git a/backend/src/services/clean_release/compliance_orchestrator.py b/backend/src/services/clean_release/compliance_orchestrator.py
index e7b7f7be..7d93fa58 100644
--- a/backend/src/services/clean_release/compliance_orchestrator.py
+++ b/backend/src/services/clean_release/compliance_orchestrator.py
@@ -1,11 +1,11 @@
-# [DEF:compliance_orchestrator:Module]
+# [DEF:ComplianceOrchestrator:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, orchestrator, compliance-gate, stages
 # @PURPOSE: Execute mandatory clean compliance stages and produce final COMPLIANT/BLOCKED/FAILED outcome.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.stages
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.report_builder
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
+# @RELATION: [DEPENDS_ON] ->[ComplianceStages]
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
 # @INVARIANT: COMPLIANT is impossible when any mandatory stage fails.
 # @TEST_CONTRACT: ComplianceCheckRun -> ComplianceCheckRun
 # @TEST_FIXTURE: compliant_candidate -> file:backend/tests/fixtures/clean_release/fixtures_clean_release.json
@@ -51,7 +51,8 @@ class CleanComplianceOrchestrator:
     def __init__(self, repository: CleanReleaseRepository):
         with belief_scope("CleanComplianceOrchestrator.__init__"):
             self.repository = repository
-    # [/DEF:CleanComplianceOrchestrator.__init__:Function]
+
+    # [/DEF:__init__:Function]
 
     # [DEF:start_check_run:Function]
     # @PURPOSE: Initiate a new compliance run session.
@@ -69,31 +70,51 @@ class CleanComplianceOrchestrator:
     ) -> ComplianceRun:
         with belief_scope("start_check_run"):
             actor = requested_by or legacy_kwargs.get("triggered_by") or "system"
-            execution_mode = str(legacy_kwargs.get("execution_mode") or "").strip().lower()
+            execution_mode = (
+                str(legacy_kwargs.get("execution_mode") or "").strip().lower()
+            )
             manifest_id_value = manifest_id
 
-            if manifest_id_value and str(manifest_id_value).strip().lower() in {"tui", "api", "scheduler"}:
+            if manifest_id_value and str(manifest_id_value).strip().lower() in {
+                "tui",
+                "api",
+                "scheduler",
+            }:
                 logger.reason(
                     "Detected legacy positional execution_mode passed through manifest_id slot",
-                    extra={"candidate_id": candidate_id, "execution_mode": manifest_id_value},
+                    extra={
+                        "candidate_id": candidate_id,
+                        "execution_mode": manifest_id_value,
+                    },
                 )
                 execution_mode = str(manifest_id_value).strip().lower()
                 manifest_id_value = None
 
-            manifest = self.repository.get_manifest(manifest_id_value) if manifest_id_value else None
+            manifest = (
+                self.repository.get_manifest(manifest_id_value)
+                if manifest_id_value
+                else None
+            )
             policy = self.repository.get_policy(policy_id)
 
             if manifest_id_value and manifest is None:
                 logger.explore(
                     "Manifest lookup missed during run start; rejecting explicit manifest contract",
-                    extra={"candidate_id": candidate_id, "manifest_id": manifest_id_value},
+                    extra={
+                        "candidate_id": candidate_id,
+                        "manifest_id": manifest_id_value,
+                    },
                 )
                 raise ValueError("Manifest or Policy not found")
 
             if policy is None:
                 logger.explore(
                     "Policy lookup missed during run start; using compatibility placeholder snapshot",
-                    extra={"candidate_id": candidate_id, "policy_id": policy_id, "execution_mode": execution_mode or "unspecified"},
+                    extra={
+                        "candidate_id": candidate_id,
+                        "policy_id": policy_id,
+                        "execution_mode": execution_mode or "unspecified",
+                    },
                 )
 
             manifest_id_value = manifest_id_value or f"manifest-{candidate_id}"
@@ -118,9 +139,14 @@ class CleanComplianceOrchestrator:
             )
             logger.reflect(
                 "Initialized compliance run with compatibility-safe dependency placeholders",
-                extra={"run_id": check_run.id, "candidate_id": candidate_id, "policy_id": policy_id},
+                extra={
+                    "run_id": check_run.id,
+                    "candidate_id": candidate_id,
+                    "policy_id": policy_id,
+                },
             )
             return self.repository.save_check_run(check_run)
+
     # [/DEF:start_check_run:Function]
 
     # [DEF:execute_stages:Function]
@@ -129,7 +155,11 @@ class CleanComplianceOrchestrator:
     # @POST: Returns persisted ComplianceRun with status FAILED on missing dependencies, otherwise SUCCEEDED with final_status set.
     # @SIDE_EFFECT: Reads candidate/policy/registry/manifest and persists updated check_run.
     # @DATA_CONTRACT: Input -> (check_run:ComplianceRun, forced_results:Optional[List[ComplianceStageRun]]), Output -> ComplianceRun
-    def execute_stages(self, check_run: ComplianceRun, forced_results: Optional[List[ComplianceStageRun]] = None) -> ComplianceRun:
+    def execute_stages(
+        self,
+        check_run: ComplianceRun,
+        forced_results: Optional[List[ComplianceStageRun]] = None,
+    ) -> ComplianceRun:
         with belief_scope("execute_stages"):
             if forced_results is not None:
                 for index, result in enumerate(forced_results, start=1):
@@ -170,12 +200,15 @@ class CleanComplianceOrchestrator:
             summary = manifest.content_json.get("summary", {})
             purity_ok = summary.get("prohibited_detected_count", 0) == 0
             check_run.final_status = (
-                ComplianceDecision.PASSED.value if purity_ok else ComplianceDecision.BLOCKED.value
+                ComplianceDecision.PASSED.value
+                if purity_ok
+                else ComplianceDecision.BLOCKED.value
             )
             check_run.status = RunStatus.SUCCEEDED
             check_run.finished_at = datetime.now(timezone.utc)
 
             return self.repository.save_check_run(check_run)
+
     # [/DEF:execute_stages:Function]
 
     # [DEF:finalize_run:Function]
@@ -202,7 +235,10 @@ class CleanComplianceOrchestrator:
             check_run.status = RunStatus.SUCCEEDED
             check_run.finished_at = datetime.now(timezone.utc)
             return self.repository.save_check_run(check_run)
+
     # [/DEF:finalize_run:Function]
+
+
 # [/DEF:CleanComplianceOrchestrator:Class]
 
 
@@ -229,5 +265,7 @@ def run_check_legacy(
         )
         run = orchestrator.execute_stages(run)
         return orchestrator.finalize_run(run)
+
+
 # [/DEF:run_check_legacy:Function]
-# [/DEF:backend.src.services.clean_release.compliance_orchestrator:Module]
\ No newline at end of file
+# [/DEF:ComplianceOrchestrator:Module]
diff --git a/backend/src/services/clean_release/demo_data_service.py b/backend/src/services/clean_release/demo_data_service.py
index b7946f76..245832b5 100644
--- a/backend/src/services/clean_release/demo_data_service.py
+++ b/backend/src/services/clean_release/demo_data_service.py
@@ -1,9 +1,9 @@
-# [DEF:demo_data_service:Module]
+# [DEF:DemoDataService:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, demo-mode, namespace, isolation, repository
 # @PURPOSE: Provide deterministic namespace helpers and isolated in-memory repository creation for demo and real modes.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
 # @INVARIANT: Demo and real namespaces must never collide for generated physical identifiers.
 
 from __future__ import annotations
@@ -20,6 +20,8 @@ def resolve_namespace(mode: str) -> str:
     if normalized == "demo":
         return "clean-release:demo"
     return "clean-release:real"
+
+
 # [/DEF:resolve_namespace:Function]
 
 
@@ -33,6 +35,8 @@ def build_namespaced_id(namespace: str, logical_id: str) -> str:
     if not logical_id or not logical_id.strip():
         raise ValueError("logical_id must be non-empty")
     return f"{namespace}::{logical_id}"
+
+
 # [/DEF:build_namespaced_id:Function]
 
 
@@ -45,6 +49,8 @@ def create_isolated_repository(mode: str) -> CleanReleaseRepository:
     repository = CleanReleaseRepository()
     setattr(repository, "namespace", namespace)
     return repository
+
+
 # [/DEF:create_isolated_repository:Function]
 
-# [/DEF:backend.src.services.clean_release.demo_data_service:Module]
\ No newline at end of file
+# [/DEF:DemoDataService:Module]
diff --git a/backend/src/services/clean_release/manifest_builder.py b/backend/src/services/clean_release/manifest_builder.py
index d7e013f1..b7d58ed0 100644
--- a/backend/src/services/clean_release/manifest_builder.py
+++ b/backend/src/services/clean_release/manifest_builder.py
@@ -1,9 +1,9 @@
-# [DEF:manifest_builder:Module]
+# [DEF:ManifestBuilder:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, manifest, deterministic-hash, summary
 # @PURPOSE: Build deterministic distribution manifest from classified artifact input.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
 # @INVARIANT: Equal semantic artifact sets produce identical deterministic hash values.
 
 from __future__ import annotations
@@ -21,7 +21,9 @@ from ...models.clean_release import (
 )
 
 
-def _stable_hash_payload(candidate_id: str, policy_id: str, items: List[ManifestItem]) -> str:
+def _stable_hash_payload(
+    candidate_id: str, policy_id: str, items: List[ManifestItem]
+) -> str:
     serialized = [
         {
             "path": item.path,
@@ -30,14 +32,25 @@ def _stable_hash_payload(candidate_id: str, policy_id: str, items: List[Manifest
             "reason": item.reason,
             "checksum": item.checksum,
         }
-        for item in sorted(items, key=lambda i: (i.path, i.category, i.classification.value, i.reason, i.checksum or ""))
+        for item in sorted(
+            items,
+            key=lambda i: (
+                i.path,
+                i.category,
+                i.classification.value,
+                i.reason,
+                i.checksum or "",
+            ),
+        )
     ]
     payload = {
         "candidate_id": candidate_id,
         "policy_id": policy_id,
         "items": serialized,
     }
-    digest = hashlib.sha256(json.dumps(payload, ensure_ascii=False, sort_keys=True).encode("utf-8")).hexdigest()
+    digest = hashlib.sha256(
+        json.dumps(payload, ensure_ascii=False, sort_keys=True).encode("utf-8")
+    ).hexdigest()
     return digest
 
 
@@ -63,8 +76,17 @@ def build_distribution_manifest(
         for a in artifacts
     ]
 
-    included_count = sum(1 for item in items if item.classification in {ClassificationType.REQUIRED_SYSTEM, ClassificationType.ALLOWED})
-    excluded_count = sum(1 for item in items if item.classification == ClassificationType.EXCLUDED_PROHIBITED)
+    included_count = sum(
+        1
+        for item in items
+        if item.classification
+        in {ClassificationType.REQUIRED_SYSTEM, ClassificationType.ALLOWED}
+    )
+    excluded_count = sum(
+        1
+        for item in items
+        if item.classification == ClassificationType.EXCLUDED_PROHIBITED
+    )
     prohibited_detected_count = excluded_count
 
     summary = ManifestSummary(
@@ -84,6 +106,8 @@ def build_distribution_manifest(
         summary=summary,
         deterministic_hash=deterministic_hash,
     )
+
+
 # [/DEF:build_distribution_manifest:Function]
 
 
@@ -105,5 +129,7 @@ def build_manifest(
         generated_by=generated_by,
         artifacts=artifacts,
     )
+
+
 # [/DEF:build_manifest:Function]
-# [/DEF:backend.src.services.clean_release.manifest_builder:Module]
\ No newline at end of file
+# [/DEF:ManifestBuilder:Module]
diff --git a/backend/src/services/clean_release/manifest_service.py b/backend/src/services/clean_release/manifest_service.py
index 692cab6a..08aad579 100644
--- a/backend/src/services/clean_release/manifest_service.py
+++ b/backend/src/services/clean_release/manifest_service.py
@@ -1,11 +1,11 @@
-# [DEF:manifest_service:Module]
+# [DEF:ManifestService:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, manifest, versioning, immutability, lifecycle
 # @PURPOSE: Build immutable distribution manifests with deterministic digest and version increment.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.manifest_builder
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
+# @RELATION: [DEPENDS_ON] ->[ManifestBuilder]
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
 # @PRE: Candidate exists and is PREPARED or MANIFEST_BUILT; artifacts are present.
 # @POST: New immutable manifest is persisted with incremented version and deterministic digest.
 # @INVARIANT: Existing manifests are never mutated.
@@ -39,8 +39,13 @@ def build_manifest_snapshot(
     if candidate is None:
         raise ValueError(f"candidate '{candidate_id}' not found")
 
-    if candidate.status not in {CandidateStatus.PREPARED.value, CandidateStatus.MANIFEST_BUILT.value}:
-        raise ValueError("candidate must be PREPARED or MANIFEST_BUILT to build manifest")
+    if candidate.status not in {
+        CandidateStatus.PREPARED.value,
+        CandidateStatus.MANIFEST_BUILT.value,
+    }:
+        raise ValueError(
+            "candidate must be PREPARED or MANIFEST_BUILT to build manifest"
+        )
 
     artifacts = repository.get_artifacts_by_candidate(candidate_id)
     if not artifacts:
@@ -83,6 +88,8 @@ def build_manifest_snapshot(
         repository.save_candidate(candidate)
 
     return manifest
+
+
 # [/DEF:build_manifest_snapshot:Function]
 
-# [/DEF:backend.src.services.clean_release.manifest_service:Module]
\ No newline at end of file
+# [/DEF:ManifestService:Module]
diff --git a/backend/src/services/clean_release/policy_engine.py b/backend/src/services/clean_release/policy_engine.py
index ae00e141..ab6a9a22 100644
--- a/backend/src/services/clean_release/policy_engine.py
+++ b/backend/src/services/clean_release/policy_engine.py
@@ -1,10 +1,10 @@
-# [DEF:policy_engine:Module]
+# [DEF:PolicyEngine:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, policy, classification, source-isolation
 # @PURPOSE: Evaluate artifact/source policies for enterprise clean profile with deterministic outcomes.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release.CleanProfilePolicy
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release.ResourceSourceRegistry
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
+# @RELATION: [DEPENDS_ON] ->[LoggerModule]
 # @INVARIANT: Enterprise-clean policy always treats non-registry sources as violations.
 
 from __future__ import annotations
@@ -54,7 +54,9 @@ class CleanPolicyEngine:
 
     def validate_policy(self) -> PolicyValidationResult:
         with belief_scope("clean_policy_engine.validate_policy"):
-            logger.reason("Validating enterprise-clean policy and internal registry consistency")
+            logger.reason(
+                "Validating enterprise-clean policy and internal registry consistency"
+            )
             reasons: List[str] = []
 
             registry_ref = (
@@ -68,38 +70,56 @@ class CleanPolicyEngine:
             content = dict(getattr(self.policy, "content_json", None) or {})
             if not content:
                 content = {
-                    "profile": getattr(getattr(self.policy, "profile", None), "value", getattr(self.policy, "profile", "standard")),
+                    "profile": getattr(
+                        getattr(self.policy, "profile", None),
+                        "value",
+                        getattr(self.policy, "profile", "standard"),
+                    ),
                     "prohibited_artifact_categories": list(
                         getattr(self.policy, "prohibited_artifact_categories", []) or []
                     ),
                     "required_system_categories": list(
                         getattr(self.policy, "required_system_categories", []) or []
                     ),
-                    "external_source_forbidden": getattr(self.policy, "external_source_forbidden", False),
+                    "external_source_forbidden": getattr(
+                        self.policy, "external_source_forbidden", False
+                    ),
                 }
 
             profile = content.get("profile", "standard")
 
             if profile == "enterprise-clean":
                 if not content.get("prohibited_artifact_categories"):
-                    reasons.append("Enterprise policy requires prohibited artifact categories")
+                    reasons.append(
+                        "Enterprise policy requires prohibited artifact categories"
+                    )
                 if not content.get("external_source_forbidden"):
-                    reasons.append("Enterprise policy requires external_source_forbidden=true")
+                    reasons.append(
+                        "Enterprise policy requires external_source_forbidden=true"
+                    )
 
-            registry_id = getattr(self.registry, "id", None) or getattr(self.registry, "registry_id", None)
+            registry_id = getattr(self.registry, "id", None) or getattr(
+                self.registry, "registry_id", None
+            )
             if registry_id != registry_ref:
                 reasons.append("Policy registry ref does not match provided registry")
 
             allowed_hosts = getattr(self.registry, "allowed_hosts", None)
             if allowed_hosts is None:
                 entries = getattr(self.registry, "entries", []) or []
-                allowed_hosts = [entry.host for entry in entries if getattr(entry, "enabled", True)]
+                allowed_hosts = [
+                    entry.host for entry in entries if getattr(entry, "enabled", True)
+                ]
 
             if not allowed_hosts:
                 reasons.append("Registry must contain allowed hosts")
 
-            logger.reflect(f"Policy validation completed. blocking_reasons={len(reasons)}")
-            return PolicyValidationResult(ok=len(reasons) == 0, blocking_reasons=reasons)
+            logger.reflect(
+                f"Policy validation completed. blocking_reasons={len(reasons)}"
+            )
+            return PolicyValidationResult(
+                ok=len(reasons) == 0, blocking_reasons=reasons
+            )
 
     def classify_artifact(self, artifact: Dict) -> str:
         category = (artifact.get("category") or "").strip()
@@ -118,10 +138,14 @@ class CleanPolicyEngine:
         prohibited = content.get("prohibited_artifact_categories", [])
 
         if category in required:
-            logger.reason(f"Artifact category '{category}' classified as required-system")
+            logger.reason(
+                f"Artifact category '{category}' classified as required-system"
+            )
             return "required-system"
         if category in prohibited:
-            logger.reason(f"Artifact category '{category}' classified as excluded-prohibited")
+            logger.reason(
+                f"Artifact category '{category}' classified as excluded-prohibited"
+            )
             return "excluded-prohibited"
         logger.reflect(f"Artifact category '{category}' classified as allowed")
         return "allowed"
@@ -129,7 +153,9 @@ class CleanPolicyEngine:
     def validate_resource_source(self, endpoint: str) -> SourceValidationResult:
         with belief_scope("clean_policy_engine.validate_resource_source"):
             if not endpoint:
-                logger.explore("Empty endpoint detected; treating as blocking external-source violation")
+                logger.explore(
+                    "Empty endpoint detected; treating as blocking external-source violation"
+                )
                 return SourceValidationResult(
                     ok=False,
                     violation={
@@ -143,12 +169,16 @@ class CleanPolicyEngine:
             allowed_hosts = getattr(self.registry, "allowed_hosts", None)
             if allowed_hosts is None:
                 entries = getattr(self.registry, "entries", []) or []
-                allowed_hosts = [entry.host for entry in entries if getattr(entry, "enabled", True)]
+                allowed_hosts = [
+                    entry.host for entry in entries if getattr(entry, "enabled", True)
+                ]
             allowed_hosts = set(allowed_hosts or [])
             normalized = endpoint.strip().lower()
 
             if normalized in allowed_hosts:
-                logger.reason(f"Endpoint '{normalized}' is present in internal allowlist")
+                logger.reason(
+                    f"Endpoint '{normalized}' is present in internal allowlist"
+                )
                 return SourceValidationResult(ok=True, violation=None)
 
             logger.explore(f"Endpoint '{endpoint}' is outside internal allowlist")
@@ -162,9 +192,13 @@ class CleanPolicyEngine:
                 },
             )
 
-    def evaluate_candidate(self, artifacts: Iterable[Dict], sources: Iterable[str]) -> Tuple[List[Dict], List[Dict]]:
+    def evaluate_candidate(
+        self, artifacts: Iterable[Dict], sources: Iterable[str]
+    ) -> Tuple[List[Dict], List[Dict]]:
         with belief_scope("clean_policy_engine.evaluate_candidate"):
-            logger.reason("Evaluating candidate artifacts and resource sources against enterprise policy")
+            logger.reason(
+                "Evaluating candidate artifacts and resource sources against enterprise policy"
+            )
             classified: List[Dict] = []
             violations: List[Dict] = []
 
@@ -192,5 +226,7 @@ class CleanPolicyEngine:
                 f"Candidate evaluation finished. artifacts={len(classified)} violations={len(violations)}"
             )
             return classified, violations
+
+
 # [/DEF:CleanPolicyEngine:Class]
-# [/DEF:backend.src.services.clean_release.policy_engine:Module]
\ No newline at end of file
+# [/DEF:PolicyEngine:Module]
diff --git a/backend/src/services/clean_release/policy_resolution_service.py b/backend/src/services/clean_release/policy_resolution_service.py
index 9bae70fe..f6b1b6b4 100644
--- a/backend/src/services/clean_release/policy_resolution_service.py
+++ b/backend/src/services/clean_release/policy_resolution_service.py
@@ -1,11 +1,11 @@
-# [DEF:policy_resolution_service:Module]
+# [DEF:PolicyResolutionService:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, policy, registry, trusted-resolution, immutable-snapshots
 # @PURPOSE: Resolve trusted policy and registry snapshots from ConfigManager without runtime overrides.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.core.config_manager
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.exceptions
+# @RELATION: [DEPENDS_ON] ->[ConfigManager]
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
+# @RELATION: [DEPENDS_ON] ->[clean_release_exceptions]
 # @INVARIANT: Trusted snapshot resolution is based only on ConfigManager active identifiers.
 
 from __future__ import annotations
@@ -30,10 +30,14 @@ def resolve_trusted_policy_snapshots(
     registry_id_override: Optional[str] = None,
 ) -> Tuple[CleanPolicySnapshot, SourceRegistrySnapshot]:
     if policy_id_override is not None or registry_id_override is not None:
-        raise PolicyResolutionError("override attempt is forbidden for trusted policy resolution")
+        raise PolicyResolutionError(
+            "override attempt is forbidden for trusted policy resolution"
+        )
 
     config = config_manager.get_config()
-    clean_release_settings = getattr(getattr(config, "settings", None), "clean_release", None)
+    clean_release_settings = getattr(
+        getattr(config, "settings", None), "clean_release", None
+    )
     if clean_release_settings is None:
         raise PolicyResolutionError("clean_release settings are missing")
 
@@ -41,17 +45,25 @@ def resolve_trusted_policy_snapshots(
     registry_id = getattr(clean_release_settings, "active_registry_id", None)
 
     if not policy_id:
-        raise PolicyResolutionError("missing trusted profile: active_policy_id is not configured")
+        raise PolicyResolutionError(
+            "missing trusted profile: active_policy_id is not configured"
+        )
     if not registry_id:
-        raise PolicyResolutionError("missing trusted registry: active_registry_id is not configured")
+        raise PolicyResolutionError(
+            "missing trusted registry: active_registry_id is not configured"
+        )
 
     policy_snapshot = repository.get_policy(policy_id)
     if policy_snapshot is None:
-        raise PolicyResolutionError(f"trusted policy snapshot '{policy_id}' was not found")
+        raise PolicyResolutionError(
+            f"trusted policy snapshot '{policy_id}' was not found"
+        )
 
     registry_snapshot = repository.get_registry(registry_id)
     if registry_snapshot is None:
-        raise PolicyResolutionError(f"trusted registry snapshot '{registry_id}' was not found")
+        raise PolicyResolutionError(
+            f"trusted registry snapshot '{registry_id}' was not found"
+        )
 
     if not bool(getattr(policy_snapshot, "immutable", False)):
         raise PolicyResolutionError("policy snapshot must be immutable")
@@ -59,6 +71,8 @@ def resolve_trusted_policy_snapshots(
         raise PolicyResolutionError("registry snapshot must be immutable")
 
     return policy_snapshot, registry_snapshot
+
+
 # [/DEF:resolve_trusted_policy_snapshots:Function]
 
-# [/DEF:backend.src.services.clean_release.policy_resolution_service:Module]
\ No newline at end of file
+# [/DEF:PolicyResolutionService:Module]
diff --git a/backend/src/services/clean_release/preparation_service.py b/backend/src/services/clean_release/preparation_service.py
index 553e281e..49575c0f 100644
--- a/backend/src/services/clean_release/preparation_service.py
+++ b/backend/src/services/clean_release/preparation_service.py
@@ -1,11 +1,11 @@
-# [DEF:preparation_service:Module]
+# [DEF:PreparationService:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, preparation, manifest, policy-evaluation
 # @PURPOSE: Prepare release candidate by policy evaluation and deterministic manifest creation.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.policy_engine
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.manifest_builder
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
+# @RELATION: [DEPENDS_ON] ->[PolicyEngine]
+# @RELATION: [DEPENDS_ON] ->[ManifestBuilder]
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
 # @INVARIANT: Candidate preparation always persists manifest and candidate status deterministically.
 
 from __future__ import annotations
@@ -35,9 +35,8 @@ def prepare_candidate(
     if policy is None:
         raise ValueError("Active clean policy not found")
 
-    registry_ref = (
-        getattr(policy, "registry_snapshot_id", None)
-        or getattr(policy, "internal_source_registry_ref", None)
+    registry_ref = getattr(policy, "registry_snapshot_id", None) or getattr(
+        policy, "internal_source_registry_ref", None
     )
     registry = repository.get_registry(registry_ref) if registry_ref else None
     if registry is None:
@@ -48,7 +47,9 @@ def prepare_candidate(
     if not validation.ok:
         raise ValueError(f"Invalid policy: {validation.blocking_reasons}")
 
-    classified, violations = engine.evaluate_candidate(artifacts=artifacts, sources=sources)
+    classified, violations = engine.evaluate_candidate(
+        artifacts=artifacts, sources=sources
+    )
 
     manifest = build_distribution_manifest(
         manifest_id=f"manifest-{candidate_id}",
@@ -65,14 +66,20 @@ def prepare_candidate(
         repository.save_candidate(candidate)
         response_status = ReleaseCandidateStatus.BLOCKED.value
     else:
-        if current_status in {CandidateStatus.DRAFT, CandidateStatus.DRAFT.value, "DRAFT"}:
+        if current_status in {
+            CandidateStatus.DRAFT,
+            CandidateStatus.DRAFT.value,
+            "DRAFT",
+        }:
             candidate.transition_to(CandidateStatus.PREPARED)
         else:
             candidate.status = ReleaseCandidateStatus.PREPARED.value
         repository.save_candidate(candidate)
         response_status = ReleaseCandidateStatus.PREPARED.value
 
-    manifest_id_value = getattr(manifest, "manifest_id", None) or getattr(manifest, "id", "")
+    manifest_id_value = getattr(manifest, "manifest_id", None) or getattr(
+        manifest, "id", ""
+    )
     return {
         "candidate_id": candidate_id,
         "status": response_status,
@@ -100,5 +107,7 @@ def prepare_candidate_legacy(
         sources=sources,
         operator_id=operator_id,
     )
+
+
 # [/DEF:prepare_candidate_legacy:Function]
-# [/DEF:backend.src.services.clean_release.preparation_service:Module]
\ No newline at end of file
+# [/DEF:PreparationService:Module]
diff --git a/backend/src/services/clean_release/publication_service.py b/backend/src/services/clean_release/publication_service.py
index 8b9497b6..d37badb5 100644
--- a/backend/src/services/clean_release/publication_service.py
+++ b/backend/src/services/clean_release/publication_service.py
@@ -1,12 +1,12 @@
-# [DEF:publication_service:Module]
+# [DEF:PublicationService:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, publication, revoke, gate, lifecycle
 # @PURPOSE: Enforce publication and revocation gates with append-only publication records.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.approval_service
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.audit_service
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
+# @RELATION: [DEPENDS_ON] ->[ApprovalService]
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
+# @RELATION: [DEPENDS_ON] ->[AuditService]
 # @INVARIANT: Publication records are append-only snapshots; revoke mutates only publication status for targeted record.
 
 from __future__ import annotations
@@ -27,12 +27,16 @@ from .repository import CleanReleaseRepository
 # @PURPOSE: Provide in-memory append-only publication storage.
 # @PRE: repository is initialized.
 # @POST: Returns publication list attached to repository.
-def _get_or_init_publications_store(repository: CleanReleaseRepository) -> List[PublicationRecord]:
+def _get_or_init_publications_store(
+    repository: CleanReleaseRepository,
+) -> List[PublicationRecord]:
     publications = getattr(repository, "publication_records", None)
     if publications is None:
         publications = []
         setattr(repository, "publication_records", publications)
     return publications
+
+
 # [/DEF:_get_or_init_publications_store:Function]
 
 
@@ -44,10 +48,20 @@ def _latest_publication_for_candidate(
     repository: CleanReleaseRepository,
     candidate_id: str,
 ) -> PublicationRecord | None:
-    records = [item for item in _get_or_init_publications_store(repository) if item.candidate_id == candidate_id]
+    records = [
+        item
+        for item in _get_or_init_publications_store(repository)
+        if item.candidate_id == candidate_id
+    ]
     if not records:
         return None
-    return sorted(records, key=lambda item: item.published_at or datetime.min.replace(tzinfo=timezone.utc), reverse=True)[0]
+    return sorted(
+        records,
+        key=lambda item: item.published_at or datetime.min.replace(tzinfo=timezone.utc),
+        reverse=True,
+    )[0]
+
+
 # [/DEF:_latest_publication_for_candidate:Function]
 
 
@@ -55,12 +69,20 @@ def _latest_publication_for_candidate(
 # @PURPOSE: Resolve latest approval decision from repository decision store.
 # @PRE: candidate_id is non-empty.
 # @POST: Returns latest decision object or None.
-def _latest_approval_for_candidate(repository: CleanReleaseRepository, candidate_id: str):
+def _latest_approval_for_candidate(
+    repository: CleanReleaseRepository, candidate_id: str
+):
     decisions = getattr(repository, "approval_decisions", [])
     scoped = [item for item in decisions if item.candidate_id == candidate_id]
     if not scoped:
         return None
-    return sorted(scoped, key=lambda item: item.decided_at or datetime.min.replace(tzinfo=timezone.utc), reverse=True)[0]
+    return sorted(
+        scoped,
+        key=lambda item: item.decided_at or datetime.min.replace(tzinfo=timezone.utc),
+        reverse=True,
+    )[0]
+
+
 # [/DEF:_latest_approval_for_candidate:Function]
 
 
@@ -78,7 +100,9 @@ def publish_candidate(
     publication_ref: str | None = None,
 ) -> PublicationRecord:
     with belief_scope("publication_service.publish_candidate"):
-        logger.reason(f"[REASON] Evaluating publish gate candidate_id={candidate_id} report_id={report_id}")
+        logger.reason(
+            f"[REASON] Evaluating publish gate candidate_id={candidate_id} report_id={report_id}"
+        )
 
         if not published_by or not published_by.strip():
             raise PublicationGateError("published_by must be non-empty")
@@ -96,11 +120,17 @@ def publish_candidate(
             raise PublicationGateError("report belongs to another candidate")
 
         latest_approval = _latest_approval_for_candidate(repository, candidate_id)
-        if latest_approval is None or latest_approval.decision != ApprovalDecisionType.APPROVED.value:
+        if (
+            latest_approval is None
+            or latest_approval.decision != ApprovalDecisionType.APPROVED.value
+        ):
             raise PublicationGateError("publish requires APPROVED decision")
 
         latest_publication = _latest_publication_for_candidate(repository, candidate_id)
-        if latest_publication is not None and latest_publication.status == PublicationStatus.ACTIVE.value:
+        if (
+            latest_publication is not None
+            and latest_publication.status == PublicationStatus.ACTIVE.value
+        ):
             raise PublicationGateError("candidate already has active publication")
 
         if candidate.status == CandidateStatus.APPROVED.value:
@@ -108,7 +138,9 @@ def publish_candidate(
                 candidate.transition_to(CandidateStatus.PUBLISHED)
                 repository.save_candidate(candidate)
             except Exception as exc:  # noqa: BLE001
-                logger.explore(f"[EXPLORE] Candidate transition to PUBLISHED failed candidate_id={candidate_id}: {exc}")
+                logger.explore(
+                    f"[EXPLORE] Candidate transition to PUBLISHED failed candidate_id={candidate_id}: {exc}"
+                )
                 raise PublicationGateError(str(exc)) from exc
 
         record = PublicationRecord(
@@ -122,9 +154,15 @@ def publish_candidate(
             status=PublicationStatus.ACTIVE.value,
         )
         _get_or_init_publications_store(repository).append(record)
-        audit_preparation(candidate_id, "PUBLISHED", repository=repository, actor=published_by)
-        logger.reflect(f"[REFLECT] Publication persisted candidate_id={candidate_id} publication_id={record.id}")
+        audit_preparation(
+            candidate_id, "PUBLISHED", repository=repository, actor=published_by
+        )
+        logger.reflect(
+            f"[REFLECT] Publication persisted candidate_id={candidate_id} publication_id={record.id}"
+        )
         return record
+
+
 # [/DEF:publish_candidate:Function]
 
 
@@ -140,7 +178,9 @@ def revoke_publication(
     comment: str | None = None,
 ) -> PublicationRecord:
     with belief_scope("publication_service.revoke_publication"):
-        logger.reason(f"[REASON] Evaluating revoke gate publication_id={publication_id}")
+        logger.reason(
+            f"[REASON] Evaluating revoke gate publication_id={publication_id}"
+        )
 
         if not revoked_by or not revoked_by.strip():
             raise PublicationGateError("revoked_by must be non-empty")
@@ -168,6 +208,8 @@ def revoke_publication(
         )
         logger.reflect(f"[REFLECT] Publication revoked publication_id={publication_id}")
         return record
+
+
 # [/DEF:revoke_publication:Function]
 
-# [/DEF:backend.src.services.clean_release.publication_service:Module]
\ No newline at end of file
+# [/DEF:backend.src.services.clean_release.publication_service:Module]
diff --git a/backend/src/services/clean_release/report_builder.py b/backend/src/services/clean_release/report_builder.py
index 91dc27a2..379522b0 100644
--- a/backend/src/services/clean_release/report_builder.py
+++ b/backend/src/services/clean_release/report_builder.py
@@ -1,10 +1,10 @@
-# [DEF:report_builder:Module]
+# [DEF:ReportBuilder:Module]
 # @COMPLEXITY: 5
 # @SEMANTICS: clean-release, report, audit, counters, violations
 # @PURPOSE: Build and persist compliance reports with consistent counter invariants.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
+# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
 # @INVARIANT: blocking_violations_count never exceeds violations_count.
 # @TEST_CONTRACT: ComplianceCheckRun,List[ComplianceViolation] -> ComplianceReport
 # @TEST_FIXTURE: blocked_with_two_violations -> file:backend/tests/fixtures/clean_release/fixtures_clean_release.json
@@ -28,7 +28,9 @@ class ComplianceReportBuilder:
     def __init__(self, repository: CleanReleaseRepository):
         self.repository = repository
 
-    def build_report_payload(self, check_run: ComplianceRun, violations: List[ComplianceViolation]) -> ComplianceReport:
+    def build_report_payload(
+        self, check_run: ComplianceRun, violations: List[ComplianceViolation]
+    ) -> ComplianceReport:
         if check_run.status == RunStatus.RUNNING:
             raise ValueError("Cannot build report for non-terminal run")
 
@@ -40,7 +42,10 @@ class ComplianceReportBuilder:
             or bool(getattr(v, "evidence_json", {}).get("blocked_release", False))
         )
 
-        if check_run.final_status == ComplianceDecision.BLOCKED and blocking_violations_count <= 0:
+        if (
+            check_run.final_status == ComplianceDecision.BLOCKED
+            and blocking_violations_count <= 0
+        ):
             raise ValueError("Blocked run requires at least one blocking violation")
 
         summary = (
@@ -65,4 +70,6 @@ class ComplianceReportBuilder:
 
     def persist_report(self, report: ComplianceReport) -> ComplianceReport:
         return self.repository.save_report(report)
-# [/DEF:backend.src.services.clean_release.report_builder:Module]
\ No newline at end of file
+
+
+# [/DEF:ReportBuilder:Module]
diff --git a/backend/src/services/clean_release/repository.py b/backend/src/services/clean_release/repository.py
index a4986075..4a773531 100644
--- a/backend/src/services/clean_release/repository.py
+++ b/backend/src/services/clean_release/repository.py
@@ -1,15 +1,15 @@
-# [DEF:repository:Module]
+# [DEF:RepositoryRelations:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, repository, persistence, in-memory
 # @PURPOSE: Provide repository adapter for clean release entities with deterministic access methods.
 # @LAYER: Infra
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
 # @INVARIANT: Repository operations are side-effect free outside explicit save/update calls.
 
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, cast
 
 from ...models.clean_release import (
     CleanPolicySnapshot,
@@ -38,15 +38,28 @@ class CleanReleaseRepository:
     violations: Dict[str, ComplianceViolation] = field(default_factory=dict)
     audit_events: List[Dict[str, Any]] = field(default_factory=list)
 
+    def _entity_id(self, entity: Any) -> str:
+        return cast(str, str(getattr(cast(Any, entity), "id")))
+
+    def _candidate_ref(self, entity: Any) -> str:
+        return cast(str, str(getattr(cast(Any, entity), "candidate_id")))
+
+    def _run_ref(self, entity: Any) -> str:
+        return cast(str, str(getattr(cast(Any, entity), "run_id")))
+
     def save_candidate(self, candidate: ReleaseCandidate) -> ReleaseCandidate:
-        self.candidates[candidate.id] = candidate
+        cast(Dict[str, ReleaseCandidate], self.candidates)[
+            self._entity_id(candidate)
+        ] = candidate
         return candidate
 
     def get_candidate(self, candidate_id: str) -> Optional[ReleaseCandidate]:
         return self.candidates.get(candidate_id)
 
     def save_policy(self, policy: CleanPolicySnapshot) -> CleanPolicySnapshot:
-        self.policies[policy.id] = policy
+        cast(Dict[str, CleanPolicySnapshot], self.policies)[self._entity_id(policy)] = (
+            policy
+        )
         return policy
 
     def get_policy(self, policy_id: str) -> Optional[CleanPolicySnapshot]:
@@ -58,36 +71,57 @@ class CleanReleaseRepository:
         return next(iter(self.policies.values()), None)
 
     def save_registry(self, registry: SourceRegistrySnapshot) -> SourceRegistrySnapshot:
-        self.registries[registry.id] = registry
+        cast(Dict[str, SourceRegistrySnapshot], self.registries)[
+            self._entity_id(registry)
+        ] = registry
         return registry
 
     def get_registry(self, registry_id: str) -> Optional[SourceRegistrySnapshot]:
         return self.registries.get(registry_id)
 
     def save_artifact(self, artifact) -> object:
-        self.artifacts[artifact.id] = artifact
+        cast(Dict[str, object], self.artifacts)[self._entity_id(artifact)] = artifact
         return artifact
 
     def get_artifacts_by_candidate(self, candidate_id: str) -> List[object]:
-        return [a for a in self.artifacts.values() if a.candidate_id == candidate_id]
+        artifacts = cast(List[Any], list(self.artifacts.values()))
+        return [
+            artifact
+            for artifact in artifacts
+            if self._candidate_ref(artifact) == candidate_id
+        ]
 
     def save_manifest(self, manifest: DistributionManifest) -> DistributionManifest:
-        self.manifests[manifest.id] = manifest
+        cast(Dict[str, DistributionManifest], self.manifests)[
+            self._entity_id(manifest)
+        ] = manifest
         return manifest
 
     def get_manifest(self, manifest_id: str) -> Optional[DistributionManifest]:
         return self.manifests.get(manifest_id)
 
-    def save_distribution_manifest(self, manifest: DistributionManifest) -> DistributionManifest:
+    def save_distribution_manifest(
+        self, manifest: DistributionManifest
+    ) -> DistributionManifest:
         return self.save_manifest(manifest)
 
-    def get_distribution_manifest(self, manifest_id: str) -> Optional[DistributionManifest]:
+    def get_distribution_manifest(
+        self, manifest_id: str
+    ) -> Optional[DistributionManifest]:
         return self.get_manifest(manifest_id)
 
     def save_check_run(self, check_run: ComplianceRun) -> ComplianceRun:
-        self.check_runs[check_run.id] = check_run
+        cast(Dict[str, ComplianceRun], self.check_runs)[self._entity_id(check_run)] = (
+            check_run
+        )
         return check_run
 
+    def save_stage_run(self, stage_run: ComplianceStageRun) -> ComplianceStageRun:
+        cast(Dict[str, ComplianceStageRun], self.stage_runs)[
+            self._entity_id(stage_run)
+        ] = stage_run
+        return stage_run
+
     def get_check_run(self, check_run_id: str) -> Optional[ComplianceRun]:
         return self.check_runs.get(check_run_id)
 
@@ -98,27 +132,49 @@ class CleanReleaseRepository:
         return self.get_check_run(run_id)
 
     def save_report(self, report: ComplianceReport) -> ComplianceReport:
-        existing = self.reports.get(report.id)
+        report_id = self._entity_id(report)
+        store = cast(Dict[str, ComplianceReport], self.reports)
+        existing = store.get(report_id)
         if existing is not None:
-            raise ValueError(f"immutable report snapshot already exists for id={report.id}")
-        self.reports[report.id] = report
+            raise ValueError(
+                f"immutable report snapshot already exists for id={report_id}"
+            )
+        store[report_id] = report
         return report
 
     def get_report(self, report_id: str) -> Optional[ComplianceReport]:
         return self.reports.get(report_id)
 
     def save_violation(self, violation: ComplianceViolation) -> ComplianceViolation:
-        self.violations[violation.id] = violation
+        cast(Dict[str, ComplianceViolation], self.violations)[
+            self._entity_id(violation)
+        ] = violation
         return violation
 
     def get_violations_by_run(self, run_id: str) -> List[ComplianceViolation]:
-        return [v for v in self.violations.values() if v.run_id == run_id]
+        violations = cast(List[ComplianceViolation], list(self.violations.values()))
+        return [
+            violation for violation in violations if self._run_ref(violation) == run_id
+        ]
+
+    def get_manifests_by_candidate(
+        self, candidate_id: str
+    ) -> List[DistributionManifest]:
+        manifests = cast(List[DistributionManifest], list(self.manifests.values()))
+        return [
+            manifest
+            for manifest in manifests
+            if self._candidate_ref(manifest) == candidate_id
+        ]
+
+    def append_audit_event(self, payload: Dict[str, Any]) -> None:
+        self.audit_events.append(payload)
 
-    def get_manifests_by_candidate(self, candidate_id: str) -> List[DistributionManifest]:
-        return [m for m in self.manifests.values() if m.candidate_id == candidate_id]
     def clear_history(self) -> None:
         self.check_runs.clear()
         self.reports.clear()
         self.violations.clear()
+
+
 # [/DEF:CleanReleaseRepository:Class]
-# [/DEF:backend.src.services.clean_release.repository:Module]
\ No newline at end of file
+# [/DEF:RepositoryRelations:Module]
diff --git a/backend/src/services/clean_release/source_isolation.py b/backend/src/services/clean_release/source_isolation.py
index 31045c8f..87141e1b 100644
--- a/backend/src/services/clean_release/source_isolation.py
+++ b/backend/src/services/clean_release/source_isolation.py
@@ -1,9 +1,9 @@
-# [DEF:source_isolation:Module]
+# [DEF:SourceIsolation:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, source-isolation, internal-only, validation
 # @PURPOSE: Validate that all resource endpoints belong to the approved internal source registry.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release.ResourceSourceRegistry
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
 # @INVARIANT: Any endpoint outside enabled registry entries is treated as external-source violation.
 
 from __future__ import annotations
@@ -13,8 +13,12 @@ from typing import Dict, Iterable, List
 from ...models.clean_release import ResourceSourceRegistry
 
 
-def validate_internal_sources(registry: ResourceSourceRegistry, endpoints: Iterable[str]) -> Dict:
-    allowed_hosts = {entry.host.strip().lower() for entry in registry.entries if entry.enabled}
+def validate_internal_sources(
+    registry: ResourceSourceRegistry, endpoints: Iterable[str]
+) -> Dict:
+    allowed_hosts = {
+        entry.host.strip().lower() for entry in registry.entries if entry.enabled
+    }
     violations: List[Dict] = []
 
     for endpoint in endpoints:
@@ -30,4 +34,6 @@ def validate_internal_sources(registry: ResourceSourceRegistry, endpoints: Itera
             )
 
     return {"ok": len(violations) == 0, "violations": violations}
-# [/DEF:backend.src.services.clean_release.source_isolation:Module]
\ No newline at end of file
+
+
+# [/DEF:SourceIsolation:Module]
diff --git a/backend/src/services/clean_release/stages/__init__.py b/backend/src/services/clean_release/stages/__init__.py
index b466be28..8fc91ddc 100644
--- a/backend/src/services/clean_release/stages/__init__.py
+++ b/backend/src/services/clean_release/stages/__init__.py
@@ -1,9 +1,10 @@
-# [DEF:stages:Module]
+# [DEF:ComplianceStages:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, compliance, stages, state-machine
 # @PURPOSE: Define compliance stage order and helper functions for deterministic run-state evaluation.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
+# @RELATION: [DEPENDS_ON] ->[ComplianceStageBase]
 # @INVARIANT: Stage order remains deterministic for all compliance runs.
 
 from __future__ import annotations
@@ -42,6 +43,8 @@ def build_default_stages() -> List[ComplianceStage]:
         NoExternalEndpointsStage(),
         ManifestConsistencyStage(),
     ]
+
+
 # [/DEF:build_default_stages:Function]
 
 
@@ -55,7 +58,9 @@ def stage_result_map(
     normalized: Dict[ComplianceStageName, CheckStageStatus] = {}
     for result in stage_results:
         if isinstance(result, CheckStageResult):
-            normalized[ComplianceStageName(result.stage.value)] = CheckStageStatus(result.status.value)
+            normalized[ComplianceStageName(result.stage.value)] = CheckStageStatus(
+                result.status.value
+            )
             continue
 
         stage_name = getattr(result, "stage_name", None)
@@ -77,6 +82,8 @@ def stage_result_map(
         elif status:
             normalized[normalized_stage] = CheckStageStatus(str(status))
     return normalized
+
+
 # [/DEF:stage_result_map:Function]
 
 
@@ -84,8 +91,12 @@ def stage_result_map(
 # @PURPOSE: Identify mandatory stages that are absent from run results.
 # @PRE: stage_status_map contains zero or more known stage statuses.
 # @POST: Returns ordered list of missing mandatory stages.
-def missing_mandatory_stages(stage_status_map: Dict[ComplianceStageName, CheckStageStatus]) -> List[ComplianceStageName]:
+def missing_mandatory_stages(
+    stage_status_map: Dict[ComplianceStageName, CheckStageStatus],
+) -> List[ComplianceStageName]:
     return [stage for stage in MANDATORY_STAGE_ORDER if stage not in stage_status_map]
+
+
 # [/DEF:missing_mandatory_stages:Function]
 
 
@@ -93,7 +104,9 @@ def missing_mandatory_stages(stage_status_map: Dict[ComplianceStageName, CheckSt
 # @PURPOSE: Derive final run status from stage results with deterministic blocking behavior.
 # @PRE: Stage statuses correspond to compliance checks.
 # @POST: Returns one of PASSED/BLOCKED/ERROR according to mandatory stage outcomes.
-def derive_final_status(stage_results: Iterable[ComplianceStageRun | CheckStageResult]) -> CheckFinalStatus:
+def derive_final_status(
+    stage_results: Iterable[ComplianceStageRun | CheckStageResult],
+) -> CheckFinalStatus:
     status_map = stage_result_map(stage_results)
     missing = missing_mandatory_stages(status_map)
     if missing:
@@ -107,5 +120,7 @@ def derive_final_status(stage_results: Iterable[ComplianceStageRun | CheckStageR
             return CheckFinalStatus.BLOCKED
 
     return CheckFinalStatus.COMPLIANT
+
+
 # [/DEF:derive_final_status:Function]
-# [/DEF:backend.src.services.clean_release.stages:Module]
\ No newline at end of file
+# [/DEF:ComplianceStages:Module]
diff --git a/backend/src/services/clean_release/stages/base.py b/backend/src/services/clean_release/stages/base.py
index e495b299..ca3f4bf2 100644
--- a/backend/src/services/clean_release/stages/base.py
+++ b/backend/src/services/clean_release/stages/base.py
@@ -1,10 +1,10 @@
-# [DEF:base:Module]
+# [DEF:ComplianceStageBase:Module]
 # @COMPLEXITY: 3
 # @SEMANTICS: clean-release, compliance, stages, contracts, base
 # @PURPOSE: Define shared contracts and helpers for pluggable clean-release compliance stages.
 # @LAYER: Domain
-# @RELATION: CALLED_BY -> backend.src.services.clean_release.compliance_execution_service
-# @RELATION: DEPENDS_ON -> backend.src.models.clean_release
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseModels]
+# @RELATION: [DEPENDS_ON] ->[LoggerModule]
 # @INVARIANT: Stage execution is deterministic for equal input context.
 
 from __future__ import annotations
@@ -37,6 +37,8 @@ class ComplianceStageContext:
     manifest: DistributionManifest
     policy: CleanPolicySnapshot
     registry: SourceRegistrySnapshot
+
+
 # [/DEF:ComplianceStageContext:Class]
 
 
@@ -47,6 +49,8 @@ class StageExecutionResult:
     decision: ComplianceDecision
     details_json: Dict[str, Any] = field(default_factory=dict)
     violations: List[ComplianceViolation] = field(default_factory=list)
+
+
 # [/DEF:StageExecutionResult:Class]
 
 
@@ -55,8 +59,9 @@ class StageExecutionResult:
 class ComplianceStage(Protocol):
     stage_name: ComplianceStageName
 
-    def execute(self, context: ComplianceStageContext) -> StageExecutionResult:
-        ...
+    def execute(self, context: ComplianceStageContext) -> StageExecutionResult: ...
+
+
 # [/DEF:ComplianceStage:Class]
 
 
@@ -78,12 +83,16 @@ def build_stage_run_record(
             id=f"stg-{uuid4()}",
             run_id=run_id,
             stage_name=stage_name.value,
-            status="SUCCEEDED" if result.decision != ComplianceDecision.ERROR else "FAILED",
+            status="SUCCEEDED"
+            if result.decision != ComplianceDecision.ERROR
+            else "FAILED",
             started_at=started_at or now,
             finished_at=finished_at or now,
             decision=result.decision.value,
             details_json=result.details_json,
         )
+
+
 # [/DEF:build_stage_run_record:Function]
 
 
@@ -118,6 +127,8 @@ def build_violation(
                 "blocked_release": blocked_release,
             },
         )
+
+
 # [/DEF:build_violation:Function]
 
-# [/DEF:backend.src.services.clean_release.stages.base:Module]
\ No newline at end of file
+# [/DEF:ComplianceStageBase:Module]
diff --git a/backend/src/services/clean_release/stages/data_purity.py b/backend/src/services/clean_release/stages/data_purity.py
index 6f5508c7..c40d6d88 100644
--- a/backend/src/services/clean_release/stages/data_purity.py
+++ b/backend/src/services/clean_release/stages/data_purity.py
@@ -3,8 +3,8 @@
 # @SEMANTICS: clean-release, compliance-stage, data-purity
 # @PURPOSE: Evaluate manifest purity counters and emit blocking violations for prohibited artifacts.
 # @LAYER: Domain
-# @RELATION: IMPLEMENTS -> backend.src.services.clean_release.stages.base.ComplianceStage
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.stages.base
+# @RELATION: [IMPLEMENTS] ->[ComplianceStage]
+# @RELATION: [DEPENDS_ON] ->[ComplianceStageBase]
 # @INVARIANT: prohibited_detected_count > 0 always yields BLOCKED stage decision.
 
 from __future__ import annotations
@@ -61,6 +61,8 @@ class DataPurityStage:
                 },
                 violations=[violation],
             )
+
+
 # [/DEF:DataPurityStage:Class]
 
-# [/DEF:backend.src.services.clean_release.stages.data_purity:Module]
\ No newline at end of file
+# [/DEF:data_purity:Module]
diff --git a/backend/src/services/clean_release/stages/internal_sources_only.py b/backend/src/services/clean_release/stages/internal_sources_only.py
index 5ab2254f..04474316 100644
--- a/backend/src/services/clean_release/stages/internal_sources_only.py
+++ b/backend/src/services/clean_release/stages/internal_sources_only.py
@@ -3,8 +3,8 @@
 # @SEMANTICS: clean-release, compliance-stage, source-isolation, registry
 # @PURPOSE: Verify manifest-declared sources belong to trusted internal registry allowlist.
 # @LAYER: Domain
-# @RELATION: IMPLEMENTS -> backend.src.services.clean_release.stages.base.ComplianceStage
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.stages.base
+# @RELATION: [IMPLEMENTS] ->[ComplianceStage]
+# @RELATION: [DEPENDS_ON] ->[ComplianceStageBase]
 # @INVARIANT: Any source host outside allowed_hosts yields BLOCKED decision with at least one violation.
 
 from __future__ import annotations
@@ -23,7 +23,10 @@ class InternalSourcesOnlyStage:
 
     def execute(self, context: ComplianceStageContext) -> StageExecutionResult:
         with belief_scope("InternalSourcesOnlyStage.execute"):
-            allowed_hosts = {str(host).strip().lower() for host in (context.registry.allowed_hosts or [])}
+            allowed_hosts = {
+                str(host).strip().lower()
+                for host in (context.registry.allowed_hosts or [])
+            }
             sources = context.manifest.content_json.get("sources", [])
             violations = []
 
@@ -32,7 +35,11 @@ class InternalSourcesOnlyStage:
             )
 
             for source in sources:
-                host = str(source.get("host", "")).strip().lower() if isinstance(source, dict) else ""
+                host = (
+                    str(source.get("host", "")).strip().lower()
+                    if isinstance(source, dict)
+                    else ""
+                )
                 if not host or host in allowed_hosts:
                     continue
 
@@ -42,7 +49,9 @@ class InternalSourcesOnlyStage:
                         stage_name=self.stage_name,
                         code="SOURCE_HOST_NOT_ALLOWED",
                         message=f"Source host '{host}' is not in trusted internal registry",
-                        artifact_path=str(source.get("path", "")) if isinstance(source, dict) else None,
+                        artifact_path=str(source.get("path", ""))
+                        if isinstance(source, dict)
+                        else None,
                         severity=ViolationSeverity.CRITICAL,
                         evidence_json={
                             "host": host,
@@ -71,6 +80,8 @@ class InternalSourcesOnlyStage:
                 },
                 violations=[],
             )
+
+
 # [/DEF:InternalSourcesOnlyStage:Class]
 
-# [/DEF:backend.src.services.clean_release.stages.internal_sources_only:Module]
\ No newline at end of file
+# [/DEF:internal_sources_only:Module]
diff --git a/backend/src/services/clean_release/stages/manifest_consistency.py b/backend/src/services/clean_release/stages/manifest_consistency.py
index 3ae53b86..a11f805c 100644
--- a/backend/src/services/clean_release/stages/manifest_consistency.py
+++ b/backend/src/services/clean_release/stages/manifest_consistency.py
@@ -3,8 +3,8 @@
 # @SEMANTICS: clean-release, compliance-stage, manifest, consistency, digest
 # @PURPOSE: Ensure run is bound to the exact manifest snapshot and digest used at run creation time.
 # @LAYER: Domain
-# @RELATION: IMPLEMENTS -> backend.src.services.clean_release.stages.base.ComplianceStage
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.stages.base
+# @RELATION: [IMPLEMENTS] ->[ComplianceStage]
+# @RELATION: [DEPENDS_ON] ->[ComplianceStageBase]
 # @INVARIANT: Digest mismatch between run and manifest yields ERROR with blocking violation evidence.
 
 from __future__ import annotations
@@ -65,6 +65,8 @@ class ManifestConsistencyStage:
                 },
                 violations=[violation],
             )
+
+
 # [/DEF:ManifestConsistencyStage:Class]
 
-# [/DEF:backend.src.services.clean_release.stages.manifest_consistency:Module]
\ No newline at end of file
+# [/DEF:manifest_consistency:Module]
diff --git a/backend/src/services/clean_release/stages/no_external_endpoints.py b/backend/src/services/clean_release/stages/no_external_endpoints.py
index 4698b05b..d1cfe88c 100644
--- a/backend/src/services/clean_release/stages/no_external_endpoints.py
+++ b/backend/src/services/clean_release/stages/no_external_endpoints.py
@@ -3,8 +3,8 @@
 # @SEMANTICS: clean-release, compliance-stage, endpoints, network
 # @PURPOSE: Block manifest payloads that expose external endpoints outside trusted schemes and hosts.
 # @LAYER: Domain
-# @RELATION: IMPLEMENTS -> backend.src.services.clean_release.stages.base.ComplianceStage
-# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.stages.base
+# @RELATION: [IMPLEMENTS] ->[ComplianceStage]
+# @RELATION: [DEPENDS_ON] ->[ComplianceStageBase]
 # @INVARIANT: Endpoint outside allowed scheme/host always yields BLOCKED stage decision.
 
 from __future__ import annotations
@@ -26,8 +26,14 @@ class NoExternalEndpointsStage:
     def execute(self, context: ComplianceStageContext) -> StageExecutionResult:
         with belief_scope("NoExternalEndpointsStage.execute"):
             endpoints = context.manifest.content_json.get("endpoints", [])
-            allowed_hosts = {str(host).strip().lower() for host in (context.registry.allowed_hosts or [])}
-            allowed_schemes = {str(scheme).strip().lower() for scheme in (context.registry.allowed_schemes or [])}
+            allowed_hosts = {
+                str(host).strip().lower()
+                for host in (context.registry.allowed_hosts or [])
+            }
+            allowed_schemes = {
+                str(scheme).strip().lower()
+                for scheme in (context.registry.allowed_schemes or [])
+            }
             violations = []
 
             logger.reason(
@@ -68,7 +74,10 @@ class NoExternalEndpointsStage:
             if violations:
                 return StageExecutionResult(
                     decision=ComplianceDecision.BLOCKED,
-                    details_json={"endpoint_count": len(endpoints), "violations_count": len(violations)},
+                    details_json={
+                        "endpoint_count": len(endpoints),
+                        "violations_count": len(violations),
+                    },
                     violations=violations,
                 )
 
@@ -77,6 +86,8 @@ class NoExternalEndpointsStage:
                 details_json={"endpoint_count": len(endpoints), "violations_count": 0},
                 violations=[],
             )
+
+
 # [/DEF:NoExternalEndpointsStage:Class]
 
-# [/DEF:backend.src.services.clean_release.stages.no_external_endpoints:Module]
\ No newline at end of file
+# [/DEF:no_external_endpoints:Module]
diff --git a/backend/src/services/health_service.py b/backend/src/services/health_service.py
index 9ae4b833..d52bc53f 100644
--- a/backend/src/services/health_service.py
+++ b/backend/src/services/health_service.py
@@ -3,14 +3,15 @@
 # @SEMANTICS: health, aggregation, dashboards
 # @PURPOSE: Business logic for aggregating dashboard health status from validation records.
 # @LAYER: Domain/Service
-# @RELATION: [DEPENDS_ON] ->[backend.src.models.llm.ValidationRecord]
-# @RELATION: [DEPENDS_ON] ->[backend.src.core.superset_client.SupersetClient]
-# @RELATION: [DEPENDS_ON] ->[backend.src.core.task_manager.cleanup.TaskCleanupService]
+# @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+# @RELATION: [DEPENDS_ON] ->[SupersetClient]
+# @RELATION: [DEPENDS_ON] ->[TaskCleanupService]
+# @RELATION: [DEPENDS_ON] ->[TaskManager]
 
-from typing import List, Dict, Any, Optional, Tuple
+from typing import List, Dict, Any, Optional, Tuple, cast
 import time
 from sqlalchemy.orm import Session
-from sqlalchemy import func, desc
+from sqlalchemy import func
 import os
 from ..models.llm import ValidationRecord
 from ..schemas.health import DashboardHealthItem, HealthSummaryResponse
@@ -20,6 +21,10 @@ from ..core.task_manager.cleanup import TaskCleanupService
 from ..core.task_manager import TaskManager
 
 
+def _empty_dashboard_meta() -> Dict[str, Optional[str]]:
+    return cast(Dict[str, Optional[str]], {"slug": None, "title": None})
+
+
 # [DEF:HealthService:Class]
 # @COMPLEXITY: 4
 # @PURPOSE: Aggregate latest dashboard validation state and manage persisted health report lifecycle.
@@ -27,12 +32,12 @@ from ..core.task_manager import TaskManager
 # @POST: Exposes health summary aggregation and validation report deletion operations.
 # @SIDE_EFFECT: Maintains in-memory dashboard metadata caches and may coordinate cleanup through collaborators.
 # @DATA_CONTRACT: Input[Session, Optional[Any]] -> Output[HealthSummaryResponse|bool]
-# @RELATION: [DEPENDS_ON] ->[sqlalchemy.orm.Session]
-# @RELATION: [DEPENDS_ON] ->[backend.src.models.llm.ValidationRecord]
-# @RELATION: [DEPENDS_ON] ->[backend.src.schemas.health.DashboardHealthItem]
-# @RELATION: [DEPENDS_ON] ->[backend.src.schemas.health.HealthSummaryResponse]
-# @RELATION: [CALLS] ->[backend.src.core.superset_client.SupersetClient]
-# @RELATION: [CALLS] ->[backend.src.core.task_manager.cleanup.TaskCleanupService]
+# @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+# @RELATION: [DEPENDS_ON] ->[DashboardHealthItem]
+# @RELATION: [DEPENDS_ON] ->[HealthSummaryResponse]
+# @RELATION: [DEPENDS_ON] ->[SupersetClient]
+# @RELATION: [DEPENDS_ON] ->[TaskCleanupService]
+# @RELATION: [DEPENDS_ON] ->[TaskManager]
 class HealthService:
     _dashboard_summary_cache: Dict[
         str, Tuple[float, Dict[str, Dict[str, Optional[str]]]]
@@ -50,8 +55,7 @@ class HealthService:
     # @POST: Service is ready to aggregate summaries and delete health reports.
     # @SIDE_EFFECT: Initializes per-instance dashboard metadata cache.
     # @DATA_CONTRACT: Input[db: Session, config_manager: Optional[Any]] -> Output[HealthService]
-    # @RELATION: [BINDS_TO] ->[backend.src.services.health_service.HealthService]
-    # @RELATION: [DEPENDS_ON] ->[sqlalchemy.orm.Session]
+    # @RELATION: [BINDS_TO] ->[HealthService]
     def __init__(self, db: Session, config_manager=None):
         self.db = db
         self.config_manager = config_manager
@@ -66,10 +70,9 @@ class HealthService:
     # @POST: Numeric dashboard ids for known environments are cached when discoverable.
     # @SIDE_EFFECT: May call Superset dashboard list API once per referenced environment.
     # @DATA_CONTRACT: Input[records: List[ValidationRecord]] -> Output[None]
-    # @RELATION: [DEPENDS_ON] ->[backend.src.models.llm.ValidationRecord]
-    # @RELATION: [DEPENDS_ON] ->[backend.src.core.superset_client.SupersetClient]
-    # @RELATION: [CALLS] ->[config_manager.get_environments]
-    # @RELATION: [CALLS] ->[backend.src.core.superset_client.SupersetClient.get_dashboards_summary]
+    # @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+    # @RELATION: [DEPENDS_ON] ->[ConfigManager]
+    # @RELATION: [DEPENDS_ON] ->[SupersetClient]
     def _prime_dashboard_meta_cache(self, records: List[ValidationRecord]) -> None:
         if not self.config_manager or not records:
             return
@@ -98,23 +101,26 @@ class HealthService:
             env = environments.get(environment_id)
             if not env:
                 for dashboard_id in dashboard_ids:
-                    self._dashboard_meta_cache[(environment_id, dashboard_id)] = {
-                        "slug": None,
-                        "title": None,
-                    }
+                    self._dashboard_meta_cache[(environment_id, dashboard_id)] = (
+                        _empty_dashboard_meta()
+                    )
                 continue
 
             try:
                 cached_meta = self.__class__._dashboard_summary_cache.get(
                     environment_id
                 )
-                cache_is_fresh = (
+                dashboard_meta_map: Dict[str, Dict[str, Optional[str]]]
+                if (
                     cached_meta is not None
                     and (time.monotonic() - cached_meta[0])
                     < self.__class__._dashboard_summary_cache_ttl_seconds
-                )
-                if cache_is_fresh:
-                    dashboard_meta_map = cached_meta[1]
+                ):
+                    cached_meta_data = cast(
+                        Tuple[float, Dict[str, Dict[str, Optional[str]]]],
+                        cached_meta,
+                    )
+                    dashboard_meta_map = cached_meta_data[1]
                 else:
                     dashboards = SupersetClient(env).get_dashboards_summary()
                     dashboard_meta_map = {
@@ -133,7 +139,7 @@ class HealthService:
                     self._dashboard_meta_cache[(environment_id, dashboard_id)] = (
                         dashboard_meta_map.get(
                             dashboard_id,
-                            {"slug": None, "title": None},
+                            _empty_dashboard_meta(),
                         )
                     )
             except Exception as exc:
@@ -143,10 +149,9 @@ class HealthService:
                     exc,
                 )
                 for dashboard_id in dashboard_ids:
-                    self._dashboard_meta_cache[(environment_id, dashboard_id)] = {
-                        "slug": None,
-                        "title": None,
-                    }
+                    self._dashboard_meta_cache[(environment_id, dashboard_id)] = (
+                        _empty_dashboard_meta()
+                    )
 
     # [/DEF:_prime_dashboard_meta_cache:Function]
 
@@ -162,20 +167,20 @@ class HealthService:
         normalized_dashboard_id = str(dashboard_id or "").strip()
         normalized_environment_id = str(environment_id or "").strip()
         if not normalized_dashboard_id:
-            return {"slug": None, "title": None}
+            return _empty_dashboard_meta()
 
         if not normalized_dashboard_id.isdigit():
             return {"slug": normalized_dashboard_id, "title": None}
 
         if not self.config_manager or not normalized_environment_id:
-            return {"slug": None, "title": None}
+            return _empty_dashboard_meta()
 
         cache_key = (normalized_environment_id, normalized_dashboard_id)
         cached = self._dashboard_meta_cache.get(cache_key)
         if cached is not None:
             return cached
 
-        meta = {"slug": None, "title": None}
+        meta = _empty_dashboard_meta()
         self._dashboard_meta_cache[cache_key] = meta
         return meta
 
@@ -188,10 +193,10 @@ class HealthService:
     # @POST: Returns HealthSummaryResponse with counts and latest record row per dashboard.
     # @SIDE_EFFECT: May call Superset API to resolve dashboard metadata.
     # @DATA_CONTRACT: Input[environment_id: Optional[str]] -> Output[HealthSummaryResponse]
-    # @RELATION: [CALLS] ->[self._prime_dashboard_meta_cache]
-    # @RELATION: [CALLS] ->[self._resolve_dashboard_meta]
+    # @RELATION: [CALLS] ->[_prime_dashboard_meta_cache]
+    # @RELATION: [CALLS] ->[_resolve_dashboard_meta]
     async def get_health_summary(
-        self, environment_id: str = None
+        self, environment_id: str = ""
     ) -> HealthSummaryResponse:
         """
         @PURPOSE: Aggregates the latest validation status for all dashboards.
@@ -228,7 +233,8 @@ class HealthService:
         unknown_count = 0
 
         for rec in records:
-            status = rec.status.upper()
+            record = cast(Any, rec)
+            status = str(record.status or "").upper()
             if status == "PASS":
                 pass_count += 1
             elif status == "WARN":
@@ -239,18 +245,34 @@ class HealthService:
                 unknown_count += 1
                 status = "UNKNOWN"
 
-            meta = self._resolve_dashboard_meta(rec.dashboard_id, rec.environment_id)
+            record_id = str(record.id or "")
+            dashboard_id = str(record.dashboard_id or "")
+            resolved_environment_id = (
+                str(record.environment_id)
+                if record.environment_id is not None
+                else None
+            )
+            response_environment_id = (
+                resolved_environment_id
+                if resolved_environment_id is not None
+                else "unknown"
+            )
+            task_id = str(record.task_id) if record.task_id is not None else None
+            summary = str(record.summary) if record.summary is not None else None
+            timestamp = cast(Any, record.timestamp)
+
+            meta = self._resolve_dashboard_meta(dashboard_id, resolved_environment_id)
             items.append(
                 DashboardHealthItem(
-                    record_id=rec.id,
-                    dashboard_id=rec.dashboard_id,
+                    record_id=record_id,
+                    dashboard_id=dashboard_id,
                     dashboard_slug=meta.get("slug"),
                     dashboard_title=meta.get("title"),
-                    environment_id=rec.environment_id or "unknown",
+                    environment_id=response_environment_id,
                     status=status,
-                    last_check=rec.timestamp,
-                    task_id=rec.task_id,
-                    summary=rec.summary,
+                    last_check=timestamp,
+                    task_id=task_id,
+                    summary=summary,
                 )
             )
 
@@ -275,11 +297,9 @@ class HealthService:
     # @POST: Returns True only when a matching record was deleted.
     # @SIDE_EFFECT: Deletes DB rows, optional screenshot file, and optional task/log persistence.
     # @DATA_CONTRACT: Input[record_id: str, task_manager: Optional[TaskManager]] -> Output[bool]
-    # @RELATION: [DEPENDS_ON] ->[backend.src.models.llm.ValidationRecord]
-    # @RELATION: [DEPENDS_ON] ->[backend.src.core.task_manager.TaskManager]
-    # @RELATION: [CALLS] ->[os.path.exists]
-    # @RELATION: [CALLS] ->[os.remove]
-    # @RELATION: [CALLS] ->[backend.src.core.task_manager.cleanup.TaskCleanupService.delete_task_with_logs]
+    # @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+    # @RELATION: [DEPENDS_ON] ->[TaskManager]
+    # @RELATION: [DEPENDS_ON] ->[TaskCleanupService]
     def delete_validation_report(
         self, record_id: str, task_manager: Optional[TaskManager] = None
     ) -> bool:
diff --git a/backend/src/services/llm_provider.py b/backend/src/services/llm_provider.py
index e0553c22..f9f44187 100644
--- a/backend/src/services/llm_provider.py
+++ b/backend/src/services/llm_provider.py
@@ -3,8 +3,9 @@
 # @SEMANTICS: service, llm, provider, encryption
 # @PURPOSE: Service for managing LLM provider configurations with encrypted API keys.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON ->[backend.src.core.database:Function]
-# @RELATION: DEPENDS_ON ->[backend.src.models.llm:Function]
+# @RELATION: [DEPENDS_ON] ->[LLMProvider]
+# @RELATION: [DEPENDS_ON] ->[EncryptionManager]
+# @RELATION: [DEPENDS_ON] ->[LLMProviderConfig]
 from typing import List, Optional, TYPE_CHECKING
 from sqlalchemy.orm import Session
 from ..models.llm import LLMProvider
@@ -17,6 +18,7 @@ if TYPE_CHECKING:
 
 MASKED_API_KEY_PLACEHOLDER = "********"
 
+
 # [DEF:_require_fernet_key:Function]
 # @COMPLEXITY: 5
 # @PURPOSE: Load and validate the Fernet key used for secret encryption.
@@ -24,28 +26,41 @@ MASKED_API_KEY_PLACEHOLDER = "********"
 # @POST: Returns validated key bytes ready for Fernet initialization.
 # @RELATION: DEPENDS_ON ->[backend.src.core.logger:Function]
 # @SIDE_EFFECT: Emits belief-state logs for missing or invalid encryption configuration.
+# @DATA_CONTRACT: Input[ENCRYPTION_KEY:str] -> Output[bytes]
 # @INVARIANT: Encryption initialization never falls back to a hardcoded secret.
 def _require_fernet_key() -> bytes:
     with belief_scope("_require_fernet_key"):
         raw_key = os.getenv("ENCRYPTION_KEY", "").strip()
         if not raw_key:
-            logger.explore("Missing ENCRYPTION_KEY blocks EncryptionManager initialization")
+            logger.explore(
+                "Missing ENCRYPTION_KEY blocks EncryptionManager initialization"
+            )
             raise RuntimeError("ENCRYPTION_KEY must be set")
 
         key = raw_key.encode()
         try:
             Fernet(key)
         except Exception as exc:
-            logger.explore("Invalid ENCRYPTION_KEY blocks EncryptionManager initialization")
+            logger.explore(
+                "Invalid ENCRYPTION_KEY blocks EncryptionManager initialization"
+            )
             raise RuntimeError("ENCRYPTION_KEY must be a valid Fernet key") from exc
 
         logger.reflect("Validated ENCRYPTION_KEY for EncryptionManager initialization")
         return key
+
+
 # [/DEF:_require_fernet_key:Function]
 
+
 # [DEF:EncryptionManager:Class]
 # @COMPLEXITY: 5
 # @PURPOSE: Handles encryption and decryption of sensitive data like API keys.
+# @RELATION: [CALLS] ->[_require_fernet_key]
+# @PRE: ENCRYPTION_KEY is configured with a valid Fernet key before instantiation.
+# @POST: Manager exposes reversible encrypt/decrypt operations for persisted secrets.
+# @SIDE_EFFECT: Initializes Fernet cryptography state from process environment.
+# @DATA_CONTRACT: Input[str] -> Output[str]
 # @INVARIANT: Uses only a validated secret key from environment.
 #
 # @TEST_CONTRACT: EncryptionManagerModel ->
@@ -67,6 +82,7 @@ class EncryptionManager:
     def __init__(self):
         self.key = _require_fernet_key()
         self.fernet = Fernet(self.key)
+
     # [/DEF:EncryptionManager_init:Function]
 
     # [DEF:encrypt:Function]
@@ -76,6 +92,7 @@ class EncryptionManager:
     def encrypt(self, data: str) -> str:
         with belief_scope("encrypt"):
             return self.fernet.encrypt(data.encode()).decode()
+
     # [/DEF:encrypt:Function]
 
     # [DEF:decrypt:Function]
@@ -85,20 +102,29 @@ class EncryptionManager:
     def decrypt(self, encrypted_data: str) -> str:
         with belief_scope("decrypt"):
             return self.fernet.decrypt(encrypted_data.encode()).decode()
+
     # [/DEF:decrypt:Function]
+
+
 # [/DEF:EncryptionManager:Class]
 
+
 # [DEF:LLMProviderService:Class]
 # @COMPLEXITY: 3
 # @PURPOSE: Service to manage LLM provider lifecycle.
+# @RELATION: [DEPENDS_ON] ->[LLMProvider]
+# @RELATION: [DEPENDS_ON] ->[EncryptionManager]
+# @RELATION: [DEPENDS_ON] ->[LLMProviderConfig]
 class LLMProviderService:
     # [DEF:LLMProviderService_init:Function]
     # @PURPOSE: Initialize the service with database session.
     # @PRE: db must be a valid SQLAlchemy Session.
     # @POST: Service ready for provider operations.
+    # @RELATION: [DEPENDS_ON] ->[EncryptionManager]
     def __init__(self, db: Session):
         self.db = db
         self.encryption = EncryptionManager()
+
     # [/DEF:LLMProviderService_init:Function]
 
     # [DEF:get_all_providers:Function]
@@ -106,9 +132,11 @@ class LLMProviderService:
     # @PURPOSE: Returns all configured LLM providers.
     # @PRE: Database connection must be active.
     # @POST: Returns list of all LLMProvider records.
+    # @RELATION: [DEPENDS_ON] ->[LLMProvider]
     def get_all_providers(self) -> List[LLMProvider]:
         with belief_scope("get_all_providers"):
             return self.db.query(LLMProvider).all()
+
     # [/DEF:get_all_providers:Function]
 
     # [DEF:get_provider:Function]
@@ -116,9 +144,13 @@ class LLMProviderService:
     # @PURPOSE: Returns a single LLM provider by ID.
     # @PRE: provider_id must be a valid string.
     # @POST: Returns LLMProvider or None if not found.
+    # @RELATION: [DEPENDS_ON] ->[LLMProvider]
     def get_provider(self, provider_id: str) -> Optional[LLMProvider]:
         with belief_scope("get_provider"):
-            return self.db.query(LLMProvider).filter(LLMProvider.id == provider_id).first()
+            return (
+                self.db.query(LLMProvider).filter(LLMProvider.id == provider_id).first()
+            )
+
     # [/DEF:get_provider:Function]
 
     # [DEF:create_provider:Function]
@@ -126,6 +158,9 @@ class LLMProviderService:
     # @PURPOSE: Creates a new LLM provider with encrypted API key.
     # @PRE: config must contain valid provider configuration.
     # @POST: New provider created and persisted to database.
+    # @RELATION: [DEPENDS_ON] ->[LLMProviderConfig]
+    # @RELATION: [DEPENDS_ON] ->[LLMProvider]
+    # @RELATION: [CALLS] ->[encrypt]
     def create_provider(self, config: "LLMProviderConfig") -> LLMProvider:
         with belief_scope("create_provider"):
             encrypted_key = self.encryption.encrypt(config.api_key)
@@ -135,12 +170,13 @@ class LLMProviderService:
                 base_url=config.base_url,
                 api_key=encrypted_key,
                 default_model=config.default_model,
-                is_active=config.is_active
+                is_active=config.is_active,
             )
             self.db.add(db_provider)
             self.db.commit()
             self.db.refresh(db_provider)
             return db_provider
+
     # [/DEF:create_provider:Function]
 
     # [DEF:update_provider:Function]
@@ -148,12 +184,17 @@ class LLMProviderService:
     # @PURPOSE: Updates an existing LLM provider.
     # @PRE: provider_id must exist, config must be valid.
     # @POST: Provider updated and persisted to database.
-    def update_provider(self, provider_id: str, config: "LLMProviderConfig") -> Optional[LLMProvider]:
+    # @RELATION: [DEPENDS_ON] ->[LLMProviderConfig]
+    # @RELATION: [DEPENDS_ON] ->[LLMProvider]
+    # @RELATION: [CALLS] ->[encrypt]
+    def update_provider(
+        self, provider_id: str, config: "LLMProviderConfig"
+    ) -> Optional[LLMProvider]:
         with belief_scope("update_provider"):
             db_provider = self.get_provider(provider_id)
             if not db_provider:
                 return None
-            
+
             db_provider.provider_type = config.provider_type.value
             db_provider.name = config.name
             db_provider.base_url = config.base_url
@@ -166,10 +207,11 @@ class LLMProviderService:
                 db_provider.api_key = self.encryption.encrypt(config.api_key)
             db_provider.default_model = config.default_model
             db_provider.is_active = config.is_active
-            
+
             self.db.commit()
             self.db.refresh(db_provider)
             return db_provider
+
     # [/DEF:update_provider:Function]
 
     # [DEF:delete_provider:Function]
@@ -177,6 +219,7 @@ class LLMProviderService:
     # @PURPOSE: Deletes an LLM provider.
     # @PRE: provider_id must exist.
     # @POST: Provider removed from database.
+    # @RELATION: [DEPENDS_ON] ->[LLMProvider]
     def delete_provider(self, provider_id: str) -> bool:
         with belief_scope("delete_provider"):
             db_provider = self.get_provider(provider_id)
@@ -185,6 +228,7 @@ class LLMProviderService:
             self.db.delete(db_provider)
             self.db.commit()
             return True
+
     # [/DEF:delete_provider:Function]
 
     # [DEF:get_decrypted_api_key:Function]
@@ -192,25 +236,35 @@ class LLMProviderService:
     # @PURPOSE: Returns the decrypted API key for a provider.
     # @PRE: provider_id must exist with valid encrypted key.
     # @POST: Returns decrypted API key or None on failure.
+    # @RELATION: [DEPENDS_ON] ->[LLMProvider]
+    # @RELATION: [CALLS] ->[decrypt]
     def get_decrypted_api_key(self, provider_id: str) -> Optional[str]:
         with belief_scope("get_decrypted_api_key"):
             db_provider = self.get_provider(provider_id)
             if not db_provider:
-                logger.warning(f"[get_decrypted_api_key] Provider {provider_id} not found in database")
+                logger.warning(
+                    f"[get_decrypted_api_key] Provider {provider_id} not found in database"
+                )
                 return None
-            
+
             logger.info(f"[get_decrypted_api_key] Provider found: {db_provider.id}")
-            logger.info(f"[get_decrypted_api_key] Encrypted API key length: {len(db_provider.api_key) if db_provider.api_key else 0}")
-            
+            logger.info(
+                f"[get_decrypted_api_key] Encrypted API key length: {len(db_provider.api_key) if db_provider.api_key else 0}"
+            )
+
             try:
                 decrypted_key = self.encryption.decrypt(db_provider.api_key)
-                logger.info(f"[get_decrypted_api_key] Decryption successful, key length: {len(decrypted_key) if decrypted_key else 0}")
+                logger.info(
+                    f"[get_decrypted_api_key] Decryption successful, key length: {len(decrypted_key) if decrypted_key else 0}"
+                )
                 return decrypted_key
             except Exception as e:
                 logger.error(f"[get_decrypted_api_key] Decryption failed: {str(e)}")
                 return None
+
     # [/DEF:get_decrypted_api_key:Function]
 
+
 # [/DEF:LLMProviderService:Class]
 
 # [/DEF:llm_provider:Module]
diff --git a/backend/src/services/notifications/service.py b/backend/src/services/notifications/service.py
index 6b96529f..0ba5636e 100644
--- a/backend/src/services/notifications/service.py
+++ b/backend/src/services/notifications/service.py
@@ -4,9 +4,13 @@
 # @SEMANTICS: notifications, service, routing, dispatch, background-tasks
 # @PURPOSE:   Orchestrates notification routing based on user preferences and policy context.
 # @LAYER:     Domain
-# @RELATION:  DEPENDS_ON -> backend.src.services.notifications.providers
-# @RELATION:  DEPENDS_ON -> backend.src.services.profile_service
-# @RELATION:  DEPENDS_ON -> backend.src.models.llm
+# @RELATION: [DEPENDS_ON] ->[NotificationProvider]
+# @RELATION: [DEPENDS_ON] ->[SMTPProvider]
+# @RELATION: [DEPENDS_ON] ->[TelegramProvider]
+# @RELATION: [DEPENDS_ON] ->[SlackProvider]
+# @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+# @RELATION: [DEPENDS_ON] ->[ValidationPolicy]
+# @RELATION: [DEPENDS_ON] ->[UserDashboardPreference]
 #
 # @INVARIANT: Notifications are dispatched asynchronously via BackgroundTasks.
 # @INVARIANT: Missing profile or provider config must not crash the pipeline.
@@ -19,98 +23,165 @@ from ...core.logger import logger, belief_scope
 from ...core.config_manager import ConfigManager
 from ...models.llm import ValidationRecord, ValidationPolicy
 from ...models.profile import UserDashboardPreference
-from .providers import SMTPProvider, TelegramProvider, SlackProvider, NotificationProvider
+from .providers import (
+    SMTPProvider,
+    TelegramProvider,
+    SlackProvider,
+    NotificationProvider,
+)
 
 
 # [DEF:NotificationService:Class]
 # @PURPOSE: Routes validation reports to appropriate users and channels.
+# @COMPLEXITY: 4
+# @RELATION: [DEPENDS_ON] ->[NotificationProvider]
+# @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+# @RELATION: [DEPENDS_ON] ->[ValidationPolicy]
+# @RELATION: [DEPENDS_ON] ->[UserDashboardPreference]
+# @PRE: Service receives a live DB session and configuration manager with notification payload settings.
+# @POST: Service can resolve targets and dispatch provider sends without mutating validation records.
+# @SIDE_EFFECT: Reads notification configuration, queries user preferences, and dispatches provider I/O.
+# @DATA_CONTRACT: Input[ValidationRecord, Optional[ValidationPolicy], Optional[BackgroundTasks]] -> Output[None]
 class NotificationService:
+    # [DEF:NotificationService_init:Function]
+    # @COMPLEXITY: 3
+    # @PURPOSE: Bind DB and configuration collaborators used for provider initialization and routing.
+    # @RELATION: [BINDS_TO] ->[NotificationService]
+    # @RELATION: [DEPENDS_ON] ->[ValidationPolicy]
     def __init__(self, db: Session, config_manager: ConfigManager):
         self.db = db
         self.config_manager = config_manager
         self._providers: Dict[str, NotificationProvider] = {}
         self._initialized = False
 
+    # [/DEF:NotificationService_init:Function]
+
+    # [DEF:_initialize_providers:Function]
+    # @COMPLEXITY: 3
+    # @PURPOSE: Materialize configured notification channel adapters once per service lifetime.
+    # @RELATION: [DEPENDS_ON] ->[SMTPProvider]
+    # @RELATION: [DEPENDS_ON] ->[TelegramProvider]
+    # @RELATION: [DEPENDS_ON] ->[SlackProvider]
     def _initialize_providers(self):
         if self._initialized:
             return
-        
+
         # In a real implementation, we would fetch these from NotificationConfig model
         # For now, we'll use a placeholder initialization logic
         # T033 will implement the UI/API for this.
         configs = self.config_manager.get_payload().get("notifications", {})
-        
+
         if "smtp" in configs:
             self._providers["SMTP"] = SMTPProvider(configs["smtp"])
         if "telegram" in configs:
             self._providers["TELEGRAM"] = TelegramProvider(configs["telegram"])
         if "slack" in configs:
             self._providers["SLACK"] = SlackProvider(configs["slack"])
-            
+
         self._initialized = True
 
+    # [/DEF:_initialize_providers:Function]
+
+    # [DEF:dispatch_report:Function]
+    # @COMPLEXITY: 4
+    # @PURPOSE: Route one validation record to resolved owners and configured custom channels.
+    # @RELATION: [CALLS] ->[_initialize_providers]
+    # @RELATION: [CALLS] ->[_should_notify]
+    # @RELATION: [CALLS] ->[_resolve_targets]
+    # @RELATION: [CALLS] ->[_build_body]
+    # @PRE: record is persisted and providers can be initialized from configuration payload.
+    # @POST: Eligible notification sends are scheduled in background or awaited inline.
+    # @SIDE_EFFECT: Schedules or performs outbound provider sends and emits notification logs.
+    # @DATA_CONTRACT: Input[ValidationRecord, Optional[ValidationPolicy], Optional[BackgroundTasks]] -> Output[None]
     async def dispatch_report(
-        self, 
-        record: ValidationRecord, 
+        self,
+        record: ValidationRecord,
         policy: Optional[ValidationPolicy] = None,
-        background_tasks: Optional[BackgroundTasks] = None
+        background_tasks: Optional[BackgroundTasks] = None,
     ):
         """
         Route a validation record to owners and custom channels.
         @PRE: record is persisted.
         @POST: Dispatches async tasks for each resolved target.
         """
-        with belief_scope("NotificationService.dispatch_report", f"record_id={record.id}"):
+        with belief_scope(
+            "NotificationService.dispatch_report", f"record_id={record.id}"
+        ):
             self._initialize_providers()
-            
+
             # 1. Determine if we should notify based on status and policy
             should_notify = self._should_notify(record, policy)
             if not should_notify:
-                logger.reason(f"[REASON] Notification skipped for record {record.id} (status={record.status})")
+                logger.reason(
+                    f"[REASON] Notification skipped for record {record.id} (status={record.status})"
+                )
                 return
 
             # 2. Resolve targets (Owners + Custom Channels)
             targets = self._resolve_targets(record, policy)
-            
+
             # 3. Dispatch
             subject = f"Dashboard Health Alert: {record.status}"
             body = self._build_body(record)
-            
+
             for channel_type, recipient in targets:
                 provider = self._providers.get(channel_type)
                 if not provider:
-                    logger.warning(f"[NotificationService][EXPLORE] Unsupported or unconfigured channel: {channel_type}")
+                    logger.warning(
+                        f"[NotificationService][EXPLORE] Unsupported or unconfigured channel: {channel_type}"
+                    )
                     continue
-                
+
                 if background_tasks:
                     background_tasks.add_task(provider.send, recipient, subject, body)
                 else:
                     # Fallback to sync for tests or if no background_tasks provided
                     await provider.send(recipient, subject, body)
 
-    def _should_notify(self, record: ValidationRecord, policy: Optional[ValidationPolicy]) -> bool:
+    # [/DEF:dispatch_report:Function]
+
+    # [DEF:_should_notify:Function]
+    # @COMPLEXITY: 3
+    # @PURPOSE: Evaluate record status against effective alert policy.
+    # @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+    # @RELATION: [DEPENDS_ON] ->[ValidationPolicy]
+    def _should_notify(
+        self, record: ValidationRecord, policy: Optional[ValidationPolicy]
+    ) -> bool:
         condition = policy.alert_condition if policy else "FAIL_ONLY"
-        
+
         if condition == "ALWAYS":
             return True
         if condition == "WARN_AND_FAIL":
             return record.status in ("WARN", "FAIL")
         return record.status == "FAIL"
 
-    def _resolve_targets(self, record: ValidationRecord, policy: Optional[ValidationPolicy]) -> List[tuple]:
+    # [/DEF:_should_notify:Function]
+
+    # [DEF:_resolve_targets:Function]
+    # @COMPLEXITY: 3
+    # @PURPOSE: Resolve owner and policy-defined delivery targets for one validation record.
+    # @RELATION: [CALLS] ->[_find_dashboard_owners]
+    # @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+    # @RELATION: [DEPENDS_ON] ->[ValidationPolicy]
+    def _resolve_targets(
+        self, record: ValidationRecord, policy: Optional[ValidationPolicy]
+    ) -> List[tuple]:
         targets = []
-        
+
         # Owner routing
         if not policy or policy.notify_owners:
             owners = self._find_dashboard_owners(record)
             for owner_pref in owners:
                 if not owner_pref.notify_on_fail:
                     continue
-                
+
                 if owner_pref.telegram_id:
                     targets.append(("TELEGRAM", owner_pref.telegram_id))
-                
-                email = owner_pref.email_address or getattr(owner_pref.user, "email", None)
+
+                email = owner_pref.email_address or getattr(
+                    owner_pref.user, "email", None
+                )
                 if email:
                     targets.append(("SMTP", email))
 
@@ -119,20 +190,37 @@ class NotificationService:
             for channel in policy.custom_channels:
                 # channel format: {"type": "SLACK", "target": "#alerts"}
                 targets.append((channel.get("type"), channel.get("target")))
-                
+
         return targets
 
-    def _find_dashboard_owners(self, record: ValidationRecord) -> List[UserDashboardPreference]:
-        # This is a simplified owner lookup. 
+    # [/DEF:_resolve_targets:Function]
+
+    # [DEF:_find_dashboard_owners:Function]
+    # @COMPLEXITY: 3
+    # @PURPOSE: Load candidate dashboard owners from persisted profile preferences.
+    # @RELATION: [DEPENDS_ON] ->[ValidationRecord]
+    # @RELATION: [DEPENDS_ON] ->[UserDashboardPreference]
+    def _find_dashboard_owners(
+        self, record: ValidationRecord
+    ) -> List[UserDashboardPreference]:
+        # This is a simplified owner lookup.
         # In a real scenario, we'd query Superset for owners, then match them to our UserDashboardPreference.
         # For now, we'll return all users who have bound this dashboard's environment and have a username.
-        
+
         # Placeholder: return all preferences that have a superset_username
         # (In production, we'd filter by actual ownership from Superset metadata)
-        return self.db.query(UserDashboardPreference).filter(
-            UserDashboardPreference.superset_username != None
-        ).all()
+        return (
+            self.db.query(UserDashboardPreference)
+            .filter(UserDashboardPreference.superset_username != None)
+            .all()
+        )
 
+    # [/DEF:_find_dashboard_owners:Function]
+
+    # [DEF:_build_body:Function]
+    # @COMPLEXITY: 2
+    # @PURPOSE: Format one validation record into provider-ready body text.
+    # @RELATION: [DEPENDS_ON] ->[ValidationRecord]
     def _build_body(self, record: ValidationRecord) -> str:
         return (
             f"Dashboard ID: {record.dashboard_id}\n"
@@ -141,6 +229,10 @@ class NotificationService:
             f"Summary: {record.summary}\n\n"
             f"Issues found: {len(record.issues)}"
         )
+
+    # [/DEF:_build_body:Function]
+
+
 # [/DEF:NotificationService:Class]
 
-# [/DEF:service:Module]
\ No newline at end of file
+# [/DEF:service:Module]
diff --git a/backend/src/services/reports/report_service.py b/backend/src/services/reports/report_service.py
index 1d9a22f2..6ebc82ab 100644
--- a/backend/src/services/reports/report_service.py
+++ b/backend/src/services/reports/report_service.py
@@ -3,9 +3,13 @@
 # @SEMANTICS: reports, service, aggregation, filtering, pagination, detail
 # @PURPOSE: Aggregate, normalize, filter, and paginate task reports for unified list/detail API use cases.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON ->[backend.src.core.task_manager.manager.TaskManager:Function]
-# @RELATION: DEPENDS_ON ->[backend.src.models.report:Function]
-# @RELATION: DEPENDS_ON ->[backend.src.services.reports.normalizer:Function]
+# @RELATION: [DEPENDS_ON] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[TaskReport]
+# @RELATION: [DEPENDS_ON] ->[ReportQuery]
+# @RELATION: [DEPENDS_ON] ->[ReportCollection]
+# @RELATION: [DEPENDS_ON] ->[ReportDetailView]
+# @RELATION: [DEPENDS_ON] ->[normalize_task_report]
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseRepository]
 # @INVARIANT: List responses are deterministic and include applied filter echo metadata.
 
 # [SECTION: IMPORTS]
@@ -15,7 +19,14 @@ from typing import List, Optional
 from ...core.logger import belief_scope
 
 from ...core.task_manager import TaskManager
-from ...models.report import ReportCollection, ReportDetailView, ReportQuery, ReportStatus, TaskReport, TaskType
+from ...models.report import (
+    ReportCollection,
+    ReportDetailView,
+    ReportQuery,
+    ReportStatus,
+    TaskReport,
+    TaskType,
+)
 from ..clean_release.repository import CleanReleaseRepository
 from .normalizer import normalize_task_report
 # [/SECTION]
@@ -26,6 +37,11 @@ from .normalizer import normalize_task_report
 # @COMPLEXITY: 5
 # @PRE: TaskManager dependency is initialized.
 # @POST: Provides deterministic list/detail report responses.
+# @RELATION: [DEPENDS_ON] ->[TaskManager]
+# @RELATION: [DEPENDS_ON] ->[CleanReleaseRepository]
+# @RELATION: [CALLS] ->[normalize_task_report]
+# @SIDE_EFFECT: Reads task history and optional clean-release repository state without mutating source records.
+# @DATA_CONTRACT: Input[TaskManager, Optional[CleanReleaseRepository], ReportQuery|report_id] -> Output[ReportCollection|ReportDetailView|None]
 # @INVARIANT: Service methods are read-only over task history source.
 #
 # @TEST_CONTRACT: ReportsServiceModel ->
@@ -47,11 +63,21 @@ class ReportsService:
     # @PRE: task_manager is a live TaskManager instance.
     # @POST: self.task_manager is assigned and ready for read operations.
     # @INVARIANT: Constructor performs no task mutations.
+    # @RELATION: [BINDS_TO] ->[ReportsService]
+    # @RELATION: [DEPENDS_ON] ->[TaskManager]
+    # @RELATION: [DEPENDS_ON] ->[CleanReleaseRepository]
+    # @SIDE_EFFECT: Stores collaborator references for later read-only report projections.
+    # @DATA_CONTRACT: Input[TaskManager, Optional[CleanReleaseRepository]] -> Output[ReportsService]
     # @PARAM: task_manager (TaskManager) - Task manager providing source task history.
-    def __init__(self, task_manager: TaskManager, clean_release_repository: Optional[CleanReleaseRepository] = None):
+    def __init__(
+        self,
+        task_manager: TaskManager,
+        clean_release_repository: Optional[CleanReleaseRepository] = None,
+    ):
         with belief_scope("__init__"):
             self.task_manager = task_manager
             self.clean_release_repository = clean_release_repository
+
     # [/DEF:init:Function]
 
     # [DEF:_load_normalized_reports:Function]
@@ -65,6 +91,7 @@ class ReportsService:
             tasks = self.task_manager.get_all_tasks()
             reports = [normalize_task_report(task) for task in tasks]
             return reports
+
     # [/DEF:_load_normalized_reports:Function]
 
     # [DEF:_to_utc_datetime:Function]
@@ -81,6 +108,7 @@ class ReportsService:
             if value.tzinfo is None:
                 return value.replace(tzinfo=timezone.utc)
             return value.astimezone(timezone.utc)
+
     # [/DEF:_to_utc_datetime:Function]
 
     # [DEF:_datetime_sort_key:Function]
@@ -96,6 +124,7 @@ class ReportsService:
             if updated is None:
                 return 0.0
             return updated.timestamp()
+
     # [/DEF:_datetime_sort_key:Function]
 
     # [DEF:_matches_query:Function]
@@ -116,9 +145,17 @@ class ReportsService:
             query_time_from = self._to_utc_datetime(query.time_from)
             query_time_to = self._to_utc_datetime(query.time_to)
 
-            if query_time_from and report_updated_at and report_updated_at < query_time_from:
+            if (
+                query_time_from
+                and report_updated_at
+                and report_updated_at < query_time_from
+            ):
                 return False
-            if query_time_to and report_updated_at and report_updated_at > query_time_to:
+            if (
+                query_time_to
+                and report_updated_at
+                and report_updated_at > query_time_to
+            ):
                 return False
             if query.search:
                 needle = query.search.lower()
@@ -126,6 +163,7 @@ class ReportsService:
                 if needle not in haystack:
                     return False
             return True
+
     # [/DEF:_matches_query:Function]
 
     # [DEF:_sort_reports:Function]
@@ -136,7 +174,9 @@ class ReportsService:
     # @PARAM: reports (List[TaskReport]) - Filtered reports.
     # @PARAM: query (ReportQuery) - Sort config.
     # @RETURN: List[TaskReport] - Sorted reports.
-    def _sort_reports(self, reports: List[TaskReport], query: ReportQuery) -> List[TaskReport]:
+    def _sort_reports(
+        self, reports: List[TaskReport], query: ReportQuery
+    ) -> List[TaskReport]:
         with belief_scope("_sort_reports"):
             reverse = query.sort_order == "desc"
 
@@ -148,6 +188,7 @@ class ReportsService:
                 reports.sort(key=self._datetime_sort_key, reverse=reverse)
 
             return reports
+
     # [/DEF:_sort_reports:Function]
 
     # [DEF:list_reports:Function]
@@ -159,7 +200,9 @@ class ReportsService:
     def list_reports(self, query: ReportQuery) -> ReportCollection:
         with belief_scope("list_reports"):
             reports = self._load_normalized_reports()
-            filtered = [report for report in reports if self._matches_query(report, query)]
+            filtered = [
+                report for report in reports if self._matches_query(report, query)
+            ]
             sorted_reports = self._sort_reports(filtered, query)
 
             total = len(sorted_reports)
@@ -176,6 +219,7 @@ class ReportsService:
                 has_next=has_next,
                 applied_filters=query,
             )
+
     # [/DEF:list_reports:Function]
 
     # [DEF:get_report_detail:Function]
@@ -187,13 +231,17 @@ class ReportsService:
     def get_report_detail(self, report_id: str) -> Optional[ReportDetailView]:
         with belief_scope("get_report_detail"):
             reports = self._load_normalized_reports()
-            target = next((report for report in reports if report.report_id == report_id), None)
+            target = next(
+                (report for report in reports if report.report_id == report_id), None
+            )
             if not target:
                 return None
 
             timeline = []
             if target.started_at:
-                timeline.append({"event": "started", "at": target.started_at.isoformat()})
+                timeline.append(
+                    {"event": "started", "at": target.started_at.isoformat()}
+                )
             timeline.append({"event": "updated", "at": target.updated_at.isoformat()})
 
             diagnostics = target.details or {}
@@ -202,12 +250,17 @@ class ReportsService:
             if target.error_context:
                 diagnostics["error_context"] = target.error_context.model_dump()
 
-            if target.task_type == TaskType.CLEAN_RELEASE and self.clean_release_repository is not None:
+            if (
+                target.task_type == TaskType.CLEAN_RELEASE
+                and self.clean_release_repository is not None
+            ):
                 run_id = None
                 if isinstance(diagnostics, dict):
                     result_payload = diagnostics.get("result")
                     if isinstance(result_payload, dict):
-                        run_id = result_payload.get("run_id") or result_payload.get("check_run_id")
+                        run_id = result_payload.get("run_id") or result_payload.get(
+                            "check_run_id"
+                        )
                 if run_id:
                     run = self.clean_release_repository.get_check_run(str(run_id))
                     if run is not None:
@@ -219,7 +272,11 @@ class ReportsService:
                             "requested_by": run.requested_by,
                         }
                         linked_report = next(
-                            (item for item in self.clean_release_repository.reports.values() if item.run_id == run.id),
+                            (
+                                item
+                                for item in self.clean_release_repository.reports.values()
+                                if item.run_id == run.id
+                            ),
                             None,
                         )
                         if linked_report is not None:
@@ -240,7 +297,10 @@ class ReportsService:
                 diagnostics=diagnostics,
                 next_actions=next_actions,
             )
+
     # [/DEF:get_report_detail:Function]
+
+
 # [/DEF:ReportsService:Class]
 
-# [/DEF:report_service:Module]
\ No newline at end of file
+# [/DEF:report_service:Module]
diff --git a/backend/tests/core/migration/test_archive_parser.py b/backend/tests/core/migration/test_archive_parser.py
index 43a86e66..e2ee4fc9 100644
--- a/backend/tests/core/migration/test_archive_parser.py
+++ b/backend/tests/core/migration/test_archive_parser.py
@@ -3,7 +3,7 @@
 # @COMPLEXITY: 3
 # @PURPOSE: Unit tests for MigrationArchiveParser ZIP extraction contract.
 # @LAYER: Domain
-# @RELATION: VERIFIES -> backend.src.core.migration.archive_parser
+# @RELATION: DEPENDS_ON -> [MigrationArchiveParserModule]
 #
 import os
 import sys
@@ -23,6 +23,11 @@ from src.core.migration.archive_parser import MigrationArchiveParser
 # [DEF:test_extract_objects_from_zip_collects_all_types:Function]
 # @RELATION: BINDS_TO -> TestArchiveParser
 # @PURPOSE: Verify archive parser collects dashboard/chart/dataset YAML objects into typed buckets.
+# @TEST_CONTRACT: zip_archive_fixture -> typed dashboard/chart/dataset extraction buckets
+# @TEST_SCENARIO: archive_with_supported_objects_extracts_all_types -> One YAML file per supported type lands in matching bucket.
+# @TEST_EDGE: missing_field -> Missing typed folder prevents that object class from being extracted.
+# @TEST_EDGE: invalid_type -> Unsupported file layout is ignored by typed extraction buckets.
+# @TEST_EDGE: external_fail -> Corrupt archive would fail extraction before typed buckets are returned.
 def test_extract_objects_from_zip_collects_all_types():
     parser = MigrationArchiveParser()
     with tempfile.TemporaryDirectory() as td:
diff --git a/backend/tests/core/migration/test_dry_run_orchestrator.py b/backend/tests/core/migration/test_dry_run_orchestrator.py
index 2d4069d4..9a0ac168 100644
--- a/backend/tests/core/migration/test_dry_run_orchestrator.py
+++ b/backend/tests/core/migration/test_dry_run_orchestrator.py
@@ -3,7 +3,7 @@
 # @COMPLEXITY: 3
 # @PURPOSE: Unit tests for MigrationDryRunService diff and risk computation contracts.
 # @LAYER: Domain
-# @RELATION: VERIFIES -> [MigrationDryRunOrchestratorModule]
+# @RELATION: DEPENDS_ON -> [MigrationDryRunOrchestratorModule]
 #
 import json
 import sys
@@ -56,6 +56,11 @@ def _make_session():
 # [DEF:test_migration_dry_run_service_builds_diff_and_risk:Function]
 # @RELATION: BINDS_TO -> [TestDryRunOrchestrator]
 # @PURPOSE: Verify dry-run orchestration returns stable diff summary and required risk codes.
+# @TEST_SCENARIO: dry_run_builds_diff_and_risk -> Stable diff summary and required risk codes are returned.
+# @TEST_EDGE: missing_field -> Missing target datasource remains visible in risk items.
+# @TEST_EDGE: invalid_type -> Broken dataset reference remains visible in risk items.
+# @TEST_EDGE: external_fail -> Engine transform stub failure would stop result production.
+# @TEST_INVARIANT: dry_run_result_contract_matches_fixture -> VERIFIED_BY: [dry_run_builds_diff_and_risk]
 def test_migration_dry_run_service_builds_diff_and_risk():
     # @TEST_CONTRACT: dry_run_result_contract -> {
     #   required_fields: {diff: object, summary: object, risk: object},
diff --git a/backend/tests/test_resource_hubs.py b/backend/tests/test_resource_hubs.py
index e46267dd..c05ff603 100644
--- a/backend/tests/test_resource_hubs.py
+++ b/backend/tests/test_resource_hubs.py
@@ -1,5 +1,6 @@
 # [DEF:TestResourceHubs:Module]
-# @RELATION: BELONGS_TO -> SrcRoot
+# @RELATION: DEPENDS_ON -> [DashboardsApi]
+# @RELATION: DEPENDS_ON -> [DatasetsApi]
 # @COMPLEXITY: 3
 # @SEMANTICS: tests, resource-hubs, dashboards, datasets, pagination, api
 # @PURPOSE: Contract tests for resource hub dashboards/datasets listing and pagination boundary validation.
@@ -17,14 +18,20 @@ from src.dependencies import (
 
 client = TestClient(app)
 
-# [DEF:test_dashboards_api:Test]
-# @RELATION: BINDS_TO -> TestResourceHubs
+# [DEF:test_dashboards_api:Block]
+# @RELATION: BINDS_TO -> [TestResourceHubs]
 # @PURPOSE: Verify GET /api/dashboards contract compliance
-# @TEST: Valid env_id returns 200 and dashboard list
-# @TEST: Invalid env_id returns 404
-# @TEST: Search filter works
+# @TEST_CONTRACT: dashboards_query -> dashboards payload or not_found response
+# @TEST_SCENARIO: dashboards_env_found_returns_payload -> HTTP 200 returns normalized dashboards list.
+# @TEST_SCENARIO: dashboards_unknown_env_returns_not_found -> HTTP 404 is returned for unknown env_id.
+# @TEST_SCENARIO: dashboards_search_filters_results -> Search narrows payload to matching dashboard title.
+# @TEST_INVARIANT: dashboards_route_contract_stays_observable -> VERIFIED_BY: [dashboards_env_found_returns_payload, dashboards_unknown_env_returns_not_found, dashboards_search_filters_results]
 
 
+# [DEF:mock_deps:Function]
+# @PURPOSE: Provide dependency override fixture for resource hub route tests.
+# @RELATION: BINDS_TO -> [TestResourceHubs]
+# @TEST_FIXTURE: resource_hub_overrides -> INLINE_JSON
 @pytest.fixture
 def mock_deps():
     # @INVARIANT: unconstrained mock — no spec= enforced; attribute typos will silently pass
@@ -89,8 +96,11 @@ def mock_deps():
     app.dependency_overrides.clear()
 
 
+# [/DEF:mock_deps:Function]
+
+
 # [DEF:test_get_dashboards_success:Function]
-# @RELATION: BINDS_TO -> test_dashboards_api
+# @RELATION: BINDS_TO -> [test_dashboards_api]
 # @PURPOSE: Verify dashboards endpoint returns 200 with expected dashboard payload fields.
 def test_get_dashboards_success(mock_deps):
     response = client.get("/api/dashboards?env_id=env1")
@@ -106,7 +116,7 @@ def test_get_dashboards_success(mock_deps):
 
 
 # [DEF:test_get_dashboards_not_found:Function]
-# @RELATION: BINDS_TO -> test_dashboards_api
+# @RELATION: BINDS_TO -> [test_dashboards_api]
 # @PURPOSE: Verify dashboards endpoint returns 404 for unknown environment identifier.
 def test_get_dashboards_not_found(mock_deps):
     response = client.get("/api/dashboards?env_id=invalid")
@@ -117,7 +127,7 @@ def test_get_dashboards_not_found(mock_deps):
 
 
 # [DEF:test_get_dashboards_search:Function]
-# @RELATION: BINDS_TO -> test_dashboards_api
+# @RELATION: BINDS_TO -> [test_dashboards_api]
 # @PURPOSE: Verify dashboards endpoint search filter returns matching subset.
 def test_get_dashboards_search(mock_deps):
     response = client.get("/api/dashboards?env_id=env1&search=Sales")
@@ -128,20 +138,22 @@ def test_get_dashboards_search(mock_deps):
 
 
 # [/DEF:test_get_dashboards_search:Function]
-# [/DEF:test_dashboards_api:Test]
+# [/DEF:test_dashboards_api:Block]
 
 
-# [DEF:test_datasets_api:Test]
-# @RELATION: BINDS_TO -> TestResourceHubs
+# [DEF:test_datasets_api:Block]
+# @RELATION: BINDS_TO -> [TestResourceHubs]
 # @PURPOSE: Verify GET /api/datasets contract compliance
-# @TEST: Valid env_id returns 200 and dataset list
-# @TEST: Invalid env_id returns 404
-# @TEST: Search filter works
-# @TEST: Negative - Service failure returns 503
+# @TEST_CONTRACT: datasets_query -> datasets payload or error response
+# @TEST_SCENARIO: datasets_env_found_returns_payload -> HTTP 200 returns normalized datasets list.
+# @TEST_SCENARIO: datasets_unknown_env_returns_not_found -> HTTP 404 is returned for unknown env_id.
+# @TEST_SCENARIO: datasets_search_filters_results -> Search narrows payload to matching dataset table.
+# @TEST_SCENARIO: datasets_service_failure_returns_503 -> Backend fetch failure surfaces as HTTP 503.
+# @TEST_INVARIANT: datasets_route_contract_stays_observable -> VERIFIED_BY: [datasets_env_found_returns_payload, datasets_unknown_env_returns_not_found, datasets_search_filters_results, datasets_service_failure_returns_503]
 
 
 # [DEF:test_get_datasets_success:Function]
-# @RELATION: BINDS_TO -> test_datasets_api
+# @RELATION: BINDS_TO -> [test_datasets_api]
 # @PURPOSE: Verify datasets endpoint returns 200 with mapped fields payload.
 def test_get_datasets_success(mock_deps):
     mock_deps["resource"].get_datasets_with_status = AsyncMock(
@@ -170,7 +182,7 @@ def test_get_datasets_success(mock_deps):
 
 
 # [DEF:test_get_datasets_not_found:Function]
-# @RELATION: BINDS_TO -> test_datasets_api
+# @RELATION: BINDS_TO -> [test_datasets_api]
 # @PURPOSE: Verify datasets endpoint returns 404 for unknown environment identifier.
 def test_get_datasets_not_found(mock_deps):
     response = client.get("/api/datasets?env_id=invalid")
@@ -181,7 +193,7 @@ def test_get_datasets_not_found(mock_deps):
 
 
 # [DEF:test_get_datasets_search:Function]
-# @RELATION: BINDS_TO -> test_datasets_api
+# @RELATION: BINDS_TO -> [test_datasets_api]
 # @PURPOSE: Verify datasets endpoint search filter returns matching dataset subset.
 def test_get_datasets_search(mock_deps):
     mock_deps["resource"].get_datasets_with_status = AsyncMock(
@@ -216,7 +228,7 @@ def test_get_datasets_search(mock_deps):
 
 
 # [DEF:test_get_datasets_service_failure:Function]
-# @RELATION: BINDS_TO -> test_datasets_api
+# @RELATION: BINDS_TO -> [test_datasets_api]
 # @PURPOSE: Verify datasets endpoint surfaces backend fetch failure as HTTP 503.
 def test_get_datasets_service_failure(mock_deps):
     mock_deps["resource"].get_datasets_with_status = AsyncMock(
@@ -229,20 +241,28 @@ def test_get_datasets_service_failure(mock_deps):
 
 
 # [/DEF:test_get_datasets_service_failure:Function]
-# [/DEF:test_datasets_api:Test]
+# [/DEF:test_datasets_api:Block]
 
 
-# [DEF:test_pagination_boundaries:Test]
-# @RELATION: BINDS_TO -> TestResourceHubs
+# [DEF:test_pagination_boundaries:Block]
+# @RELATION: BINDS_TO -> [TestResourceHubs]
 # @PURPOSE: Verify pagination validation for GET endpoints
-# @TEST: page<1 and page_size>100 return 400
+# @TEST_CONTRACT: pagination_query -> validation error response
+# @TEST_SCENARIO: dashboards_zero_page_rejected -> page=0 returns HTTP 400.
+# @TEST_SCENARIO: dashboards_oversize_page_rejected -> page_size=101 returns HTTP 400.
+# @TEST_SCENARIO: datasets_zero_page_rejected -> page=0 returns HTTP 400.
+# @TEST_SCENARIO: datasets_oversize_page_rejected -> page_size=101 returns HTTP 400.
+# @TEST_EDGE: missing_field -> Missing env_id prevents route contract completion.
+# @TEST_EDGE: invalid_type -> Invalid pagination values are rejected at route validation layer.
+# @TEST_EDGE: external_fail -> Validation failure returns HTTP 400 without partial payload.
+# @TEST_INVARIANT: pagination_limits_apply_to_both_routes -> VERIFIED_BY: [dashboards_zero_page_rejected, dashboards_oversize_page_rejected, datasets_zero_page_rejected, datasets_oversize_page_rejected]
 
 
 # [DEF:test_get_dashboards_pagination_zero_page:Function]
-# @RELATION: BINDS_TO -> test_pagination_boundaries
+# @RELATION: BINDS_TO -> [test_pagination_boundaries]
 # @PURPOSE: Verify dashboards endpoint rejects page=0 with HTTP 400 validation error.
 def test_get_dashboards_pagination_zero_page(mock_deps):
-    """@TEST_EDGE: pagination_zero_page -> {page:0, status:400}"""
+    # @TEST_EDGE: pagination_zero_page -> {page: 0, status: 400}
     response = client.get("/api/dashboards?env_id=env1&page=0")
     assert response.status_code == 400
     assert "Page must be >= 1" in response.json()["detail"]
@@ -252,10 +272,10 @@ def test_get_dashboards_pagination_zero_page(mock_deps):
 
 
 # [DEF:test_get_dashboards_pagination_oversize:Function]
-# @RELATION: BINDS_TO -> test_pagination_boundaries
+# @RELATION: BINDS_TO -> [test_pagination_boundaries]
 # @PURPOSE: Verify dashboards endpoint rejects oversized page_size with HTTP 400.
 def test_get_dashboards_pagination_oversize(mock_deps):
-    """@TEST_EDGE: pagination_oversize -> {page_size:101, status:400}"""
+    # @TEST_EDGE: pagination_oversize -> {page_size: 101, status: 400}
     response = client.get("/api/dashboards?env_id=env1&page_size=101")
     assert response.status_code == 400
     assert "Page size must be between 1 and 100" in response.json()["detail"]
@@ -265,10 +285,10 @@ def test_get_dashboards_pagination_oversize(mock_deps):
 
 
 # [DEF:test_get_datasets_pagination_zero_page:Function]
-# @RELATION: BINDS_TO -> test_pagination_boundaries
+# @RELATION: BINDS_TO -> [test_pagination_boundaries]
 # @PURPOSE: Verify datasets endpoint rejects page=0 with HTTP 400.
 def test_get_datasets_pagination_zero_page(mock_deps):
-    """@TEST_EDGE: pagination_zero_page on datasets"""
+    # @TEST_EDGE: pagination_zero_page_datasets -> {page: 0, status: 400}
     response = client.get("/api/datasets?env_id=env1&page=0")
     assert response.status_code == 400
 
@@ -277,14 +297,14 @@ def test_get_datasets_pagination_zero_page(mock_deps):
 
 
 # [DEF:test_get_datasets_pagination_oversize:Function]
-# @RELATION: BINDS_TO -> test_pagination_boundaries
+# @RELATION: BINDS_TO -> [test_pagination_boundaries]
 # @PURPOSE: Verify datasets endpoint rejects oversized page_size with HTTP 400.
 def test_get_datasets_pagination_oversize(mock_deps):
-    """@TEST_EDGE: pagination_oversize on datasets"""
+    # @TEST_EDGE: pagination_oversize_datasets -> {page_size: 101, status: 400}
     response = client.get("/api/datasets?env_id=env1&page_size=101")
     assert response.status_code == 400
 
 
 # [/DEF:test_get_datasets_pagination_oversize:Function]
-# [/DEF:test_pagination_boundaries:Test]
+# [/DEF:test_pagination_boundaries:Block]
 # [/DEF:TestResourceHubs:Module]
diff --git a/docs/architecture.md b/docs/architecture.md
index e69de29b..1b9c13e7 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -0,0 +1,8 @@
+# [DEF:DocArchitecture:Module]
+# @TIER: STANDARD
+# @PURPOSE: Placeholder architecture document reserved for future normalized project architecture guidance.
+# @RELATION: DEPENDS_ON -> [DEF:Std:Architecture:Standard]
+
+Architecture guidance currently lives in `.ai/standards/architecture.md` and `.ai/MODULE_MAP.md`.
+
+# [/DEF:DocArchitecture:Module]
diff --git a/frontend/src/components/Navbar.svelte b/frontend/src/components/Navbar.svelte
index 64cc62ca..cdf4eecb 100644
--- a/frontend/src/components/Navbar.svelte
+++ b/frontend/src/components/Navbar.svelte
@@ -1,12 +1,15 @@
 <!-- [DEF:Navbar:Component] -->
 <!--
-@UX_STATE: Loading -> Default
-
 @COMPLEXITY: 3
 @SEMANTICS: navbar, navigation, header, layout
-@PURPOSE:   Main navigation bar for the application.
-@LAYER:     UI
-@RELATION:  USES -> auth
+@PURPOSE: Main navigation bar for the application.
+@LAYER: UI
+@RELATION: BINDS_TO -> [authStore]
+@RELATION: BINDS_TO -> [i18n]
+@RELATION: DEPENDS_ON -> [LanguageSwitcher]
+
+@UX_STATE: Idle -> Navigation links and settings menus are visible.
+@UX_STATE: Authenticated -> User identity and logout action are rendered.
 -->
 <script>
     import { page } from '$app/state';
diff --git a/frontend/src/components/Toast.svelte b/frontend/src/components/Toast.svelte
index cfa6ced5..c8a09fb9 100755
--- a/frontend/src/components/Toast.svelte
+++ b/frontend/src/components/Toast.svelte
@@ -1,13 +1,13 @@
 <!-- [DEF:Toast:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @SEMANTICS: toast, notification, feedback, ui
 @PURPOSE: Displays transient notifications (toasts) in the bottom-right corner.
 @LAYER: UI
-@RELATION: DEPENDS_ON -> frontend/src/lib/toasts.js
+@RELATION: BINDS_TO -> toasts
 
-@PROPS: None
-@EVENTS: None
+@UX_STATE: Empty -> Toast viewport stays mounted without visible notifications.
+@UX_STATE: Visible -> Active toast items render with type-specific emphasis.
 -->
 <script>
     // [SECTION: IMPORTS]
diff --git a/frontend/src/components/__tests__/task_log_viewer.test.js b/frontend/src/components/__tests__/task_log_viewer.test.js
index 71374c70..0fa08174 100644
--- a/frontend/src/components/__tests__/task_log_viewer.test.js
+++ b/frontend/src/components/__tests__/task_log_viewer.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, task-log, viewer, mount, components
 // @PURPOSE: Unit tests for TaskLogViewer component by mounting it and observing the DOM.
 // @LAYER: UI (Tests)
-// @RELATION: VERIFIES -> TaskLogViewer
+// @RELATION: DEPENDS_ON -> [TaskLogViewer]
 // @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.
@@ -139,7 +139,7 @@ describe('TaskLogViewer Component', () => {
         expect(() => screen.getByText(/Duplicate log entry/)).not.toThrow();
     });
 
-    // @TEST_FIXTURE valid_viewer
+    // @TEST_FIXTURE: valid_viewer -> INLINE_JSON
     it('fetches and displays historical logs in modal mode under valid_viewer fixture', async () => {
         getTaskLogsMock.mockResolvedValue([
             { timestamp: '2024-01-01T00:00:00', level: 'INFO', message: 'Modal log entry' }
@@ -155,7 +155,7 @@ describe('TaskLogViewer Component', () => {
         expect(getTaskLogs).toHaveBeenCalledWith('task-123');
     });
 
-    // @TEST_EDGE no_task_id
+    // @TEST_EDGE: no_task_id -> Null taskId does not trigger fetch.
     it('does not fetch logs if taskId is null', () => {
         render(TaskLogViewer, { inline: true, taskId: null });
         expect(getTaskLogs).not.toHaveBeenCalled();
@@ -167,4 +167,4 @@ describe('TaskLogViewer Component', () => {
         expect(component).toBeDefined();
     });
 });
-// [/DEF:frontend.src.components.__tests__.task_log_viewer:Module]
+// [/DEF:TaskLogViewerTest:Module]
diff --git a/frontend/src/components/git/__tests__/git_manager.unfinished_merge.integration.test.js b/frontend/src/components/git/__tests__/git_manager.unfinished_merge.integration.test.js
index 2f5ae8d9..920273ef 100644
--- a/frontend/src/components/git/__tests__/git_manager.unfinished_merge.integration.test.js
+++ b/frontend/src/components/git/__tests__/git_manager.unfinished_merge.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: git-manager, unfinished-merge, dialog, integration-test
 // @PURPOSE: Protect unresolved-merge dialog contract in GitManager pull flow.
 // @LAYER: UI Tests
-// @RELATION: VERIFIES -> frontend/src/components/git/GitManager.svelte
+// @RELATION: DEPENDS_ON -> [GitManager]
 
 import { describe, it, expect } from 'vitest';
 import fs from 'node:fs';
@@ -40,4 +40,4 @@ describe('GitManager unfinished merge dialog contract', () => {
     expect(source).toContain('$t.git?.unfinished_merge?.copy_commands');
   });
 });
-// [/DEF:frontend.src.components.git.__tests__.git_manager_unfinished_merge_integration:Module]
\ No newline at end of file
+// [/DEF:GitManagerUnfinishedMergeIntegrationTest:Module]
diff --git a/frontend/src/components/llm/__tests__/provider_config.integration.test.js b/frontend/src/components/llm/__tests__/provider_config.integration.test.js
index de7f19e3..3e6624c6 100644
--- a/frontend/src/components/llm/__tests__/provider_config.integration.test.js
+++ b/frontend/src/components/llm/__tests__/provider_config.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: llm, provider-config, integration-test, edit-flow, delete-flow
 // @PURPOSE: Protect edit and delete interaction contracts in LLM provider settings UI.
 // @LAYER: UI Tests
-// @RELATION: VERIFIES -> ProviderConfig
+// @RELATION: DEPENDS_ON -> [ProviderConfig]
 // @INVARIANT: Edit action keeps explicit click handler and opens normalized edit form.
 
 import { describe, it, expect } from 'vitest';
@@ -16,7 +16,7 @@ const COMPONENT_PATH = path.resolve(
 );
 
 // [DEF:provider_config_edit_contract_tests:Function]
-// @RELATION: USES -> App
+// @RELATION: BINDS_TO -> [ProviderConfigIntegrationTest]
 // @COMPLEXITY: 3
 // @PURPOSE: Validate edit and delete handler wiring plus normalized edit form state mapping.
 // @PRE: ProviderConfig component source exists in expected path.
@@ -58,4 +58,4 @@ describe('ProviderConfig edit interaction contract', () => {
   });
 });
 // [/DEF:provider_config_edit_contract_tests:Function]
-// [/DEF:frontend.src.components.llm.__tests__.provider_config_integration:Module]
+// [/DEF:ProviderConfigIntegrationTest:Module]
diff --git a/frontend/src/lib/Counter.svelte b/frontend/src/lib/Counter.svelte
index a1f678cf..95741a58 100755
--- a/frontend/src/lib/Counter.svelte
+++ b/frontend/src/lib/Counter.svelte
@@ -1,8 +1,11 @@
 <!-- [DEF:Counter:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @PURPOSE: Simple counter demo component
 @LAYER: UI
+
+@UX_STATE: Idle -> Counter renders the current value and increment action.
+@UX_STATE: Incremented -> Count increases immediately after button activation.
 -->
 <script>
   let count = $state(0);
diff --git a/frontend/src/lib/api/__tests__/reports_api.test.js b/frontend/src/lib/api/__tests__/reports_api.test.js
index 983d726b..7c6073a2 100644
--- a/frontend/src/lib/api/__tests__/reports_api.test.js
+++ b/frontend/src/lib/api/__tests__/reports_api.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, reports, api-client, query-string, error-normalization
 // @PURPOSE: Unit tests for reports API client functions: query string building, error normalization, and fetch wrappers.
 // @LAYER: Infra (Tests)
-// @RELATION: TESTS -> frontend.src.lib.api.reports
+// @RELATION: DEPENDS_ON -> [ReportsApi]
 // @INVARIANT: Pure functions produce deterministic output. Async wrappers propagate structured errors.
 
 import { describe, it, expect, vi, beforeEach } from 'vitest';
@@ -210,4 +210,4 @@ describe('getReportDetail', () => {
 });
 // [/DEF:TestGetReportsAsync:Class]
 
-// [/DEF:frontend.src.lib.api.__tests__.reports_api:Module]
+// [/DEF:ReportsApiTest:Module]
diff --git a/frontend/src/lib/api/reports.js b/frontend/src/lib/api/reports.js
index 5d47b0ad..3ce6386d 100644
--- a/frontend/src/lib/api/reports.js
+++ b/frontend/src/lib/api/reports.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: frontend, api_client, reports, wrapper
 // @PURPOSE: Wrapper-based reports API client for list/detail retrieval without direct native fetch usage.
 // @LAYER: Infra
-// @RELATION: DEPENDS_ON -> [DEF:api_module]
+// @RELATION: DEPENDS_ON -> [api_module]
 // @INVARIANT: Uses existing api wrapper methods and returns structured errors for UI-state mapping.
 
 import { api } from '../api.js';
@@ -104,4 +104,4 @@ export async function getReportDetail(reportId) {
 }
 // [/DEF:getReportDetail:Function]
 
-// [/DEF:frontend.src.lib.api.reports:Module]
\ No newline at end of file
+// [/DEF:ReportsApi:Module]
diff --git a/frontend/src/lib/auth/__tests__/permissions.test.js b/frontend/src/lib/auth/__tests__/permissions.test.js
index fee31166..77d9886a 100644
--- a/frontend/src/lib/auth/__tests__/permissions.test.js
+++ b/frontend/src/lib/auth/__tests__/permissions.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, auth, permissions, rbac
 // @PURPOSE: Verifies frontend RBAC permission parsing and access checks.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> Permissions
+// @RELATION: DEPENDS_ON -> [Permissions]
 
 import { describe, it, expect } from "vitest";
 import {
@@ -100,4 +100,4 @@ describe("auth.permissions", () => {
   });
 });
 
-// [/DEF:frontend.src.lib.auth.__tests__.permissions:Module]
\ No newline at end of file
+// [/DEF:PermissionsTest:Module]
diff --git a/frontend/src/lib/auth/permissions.js b/frontend/src/lib/auth/permissions.js
index 6a69822f..9a99e44c 100644
--- a/frontend/src/lib/auth/permissions.js
+++ b/frontend/src/lib/auth/permissions.js
@@ -3,8 +3,7 @@
 // @SEMANTICS: auth, permissions, rbac, roles
 // @PURPOSE: Shared frontend RBAC utilities for route guards and menu visibility.
 // @LAYER: Domain
-// @RELATION: USED_BY -> frontend.src.components.auth.ProtectedRoute
-// @RELATION: USED_BY -> Sidebar
+// @RELATION: DEPENDS_ON -> [authStore]
 // @INVARIANT: Admin role always bypasses explicit permission checks.
 
 const KNOWN_ACTIONS = new Set(["READ", "WRITE", "EXECUTE", "DELETE"]);
@@ -100,4 +99,4 @@ export function hasPermission(user, requirement, action = "READ") {
 }
 // [/DEF:hasPermission:Function]
 
-// [/DEF:frontend.src.lib.auth.permissions:Module]
\ No newline at end of file
+// [/DEF:Permissions:Module]
diff --git a/frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js b/frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js
index 776b22ab..ecbf6840 100644
--- a/frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js
+++ b/frontend/src/lib/components/assistant/__tests__/assistant_chat.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: assistant, integration-test, ux-contract, i18n
 // @PURPOSE: Contract-level integration checks for assistant chat panel implementation and localization wiring.
 // @LAYER: UI Tests
-// @RELATION: VERIFIES -> AssistantChatPanel
+// @RELATION: DEPENDS_ON -> [AssistantChatPanel]
 // @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.
@@ -70,7 +70,7 @@ describe('AssistantChatPanel integration contract', () => {
   it('guards first-message optimistic flow from premature history overwrite', () => {
     const source = fs.readFileSync(COMPONENT_PATH, 'utf-8');
 
-    expect(source).toContain('if (isOpen && initialized && conversationId && !loading)');
+    expect(source).toContain('if (panelVisible && initialized && conversationId && !loading)');
     expect(source).toContain('function appendLocalUserMessage(text, targetConversationId = conversationId)');
     expect(source).toContain('conversation_id: targetConversationId || null');
     expect(source).toContain('historyLoadVersion += 1;');
@@ -100,4 +100,4 @@ describe('AssistantChatPanel integration contract', () => {
   });
 });
 // [/DEF:assistant_chat_contract_tests:Function]
-// [/DEF:frontend.src.lib.components.assistant.__tests__.assistant_chat_integration:Module]
+// [/DEF:AssistantChatIntegrationTest:Module]
diff --git a/frontend/src/lib/components/assistant/__tests__/assistant_clarification.integration.test.js b/frontend/src/lib/components/assistant/__tests__/assistant_clarification.integration.test.js
index 58900463..caf34772 100644
--- a/frontend/src/lib/components/assistant/__tests__/assistant_clarification.integration.test.js
+++ b/frontend/src/lib/components/assistant/__tests__/assistant_clarification.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: assistant, clarification, integration-test, dataset-review, mixed-initiative
 // @PURPOSE: Verify AssistantChatPanel hosts the resumable dataset-review clarification flow inside the assistant drawer and refreshes workspace session state after answering.
 // @LAYER: UI Tests
-// @RELATION: [VERIFIES] ->[AssistantChatPanel]
+// @RELATION: DEPENDS_ON -> [AssistantChatPanel]
 
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { render, screen, fireEvent, waitFor } from "@testing-library/svelte";
diff --git a/frontend/src/lib/components/assistant/__tests__/assistant_first_message.integration.test.js b/frontend/src/lib/components/assistant/__tests__/assistant_first_message.integration.test.js
index e55ecae9..22c052b2 100644
--- a/frontend/src/lib/components/assistant/__tests__/assistant_first_message.integration.test.js
+++ b/frontend/src/lib/components/assistant/__tests__/assistant_first_message.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: assistant, integration-test, optimistic-message, conversation-race
 // @PURPOSE: Verify first optimistic user message stays visible while a new conversation request is pending.
 // @LAYER: UI Tests
-// @RELATION: VERIFIES -> AssistantChatPanel
+// @RELATION: DEPENDS_ON -> [AssistantChatPanel]
 // @INVARIANT: Starting a new conversation must not trigger history reload that overwrites the first local user message.
 
 import { describe, it, expect, vi, beforeEach } from 'vitest';
@@ -147,7 +147,7 @@ vi.mock('$lib/i18n', () => ({
 }));
 
 // [DEF:assistant_first_message_tests:Function]
-// @RELATION: USES -> App
+// @RELATION: BINDS_TO -> [AssistantFirstMessageIntegrationTest]
 // @COMPLEXITY: 3
 // @PURPOSE: Guard optimistic first-message UX against history reload race in new conversation flow.
 // @PRE: Assistant panel renders with open state and mocked network dependencies.
@@ -238,4 +238,4 @@ describe('AssistantChatPanel first message flow', () => {
   });
 });
 // [/DEF:assistant_first_message_tests:Function]
-// [/DEF:frontend.src.lib.components.assistant.__tests__.assistant_first_message_integration:Module]
+// [/DEF:AssistantFirstMessageIntegrationTest:Module]
diff --git a/frontend/src/lib/components/dataset-review/__tests__/source_intake_panel.ux.test.js b/frontend/src/lib/components/dataset-review/__tests__/source_intake_panel.ux.test.js
index 980ce7dc..0159db69 100644
--- a/frontend/src/lib/components/dataset-review/__tests__/source_intake_panel.ux.test.js
+++ b/frontend/src/lib/components/dataset-review/__tests__/source_intake_panel.ux.test.js
@@ -6,7 +6,7 @@
 // @SEMANTICS: dataset-review, source-intake, ux-tests, validation, recovery
 // @PURPOSE: Verify source intake entry paths, validation feedback, and submit payload behavior for US1.
 // @LAYER: UI
-// @RELATION: [VERIFIES] ->[SourceIntakePanel]
+// @RELATION: DEPENDS_ON -> [SourceIntakePanel]
 // @UX_STATE: Idle -> Default intake renders both entry paths and waits for user input.
 // @UX_STATE: Validating -> Inline feedback confirms recognized links and local payload validation.
 // @UX_STATE: Rejected -> Invalid source input remains local and exposes recovery guidance.
@@ -158,4 +158,4 @@ describe("SourceIntakePanel UX Contract", () => {
     expect(screen.getByText("Backend rejected source")).toBeDefined();
   });
 });
-// [/DEF:SourceIntakePanelUxTests:Module]
\ No newline at end of file
+// [/DEF:SourceIntakePanelUxTests:Module]
diff --git a/frontend/src/lib/components/dataset-review/__tests__/us2_semantic_workspace.ux.test.js b/frontend/src/lib/components/dataset-review/__tests__/us2_semantic_workspace.ux.test.js
index 2c37aaa9..37fb937a 100644
--- a/frontend/src/lib/components/dataset-review/__tests__/us2_semantic_workspace.ux.test.js
+++ b/frontend/src/lib/components/dataset-review/__tests__/us2_semantic_workspace.ux.test.js
@@ -7,8 +7,8 @@
 // @SEMANTICS: dataset-review, semantics, assistant, workspace, ux-tests, mapping-review
 // @PURPOSE: Verify US2 dataset review surfaces keep semantic review actionable, route clarification through AssistantChatPanel, and preserve explicit preview/mapping gates.
 // @LAYER: UI
-// @RELATION: [VERIFIES] ->[SemanticLayerReview]
-// @RELATION: [VERIFIES] ->[ExecutionMappingReview]
+// @RELATION: DEPENDS_ON -> [SemanticLayerReview]
+// @RELATION: DEPENDS_ON -> [ExecutionMappingReview]
 // @TEST_SCENARIO: semantic_review_surfaces_active_value_and_candidates -> Field-level semantic review shows provenance, candidates, and mutation callbacks.
 // @TEST_SCENARIO: mapping_review_marks_row_focused_and_requires_explicit_approval -> Mapping review keeps warning approvals explicit and highlightable.
 // @TEST_EDGE: external_fail -> Failed request surfaces inline recovery message.
diff --git a/frontend/src/lib/components/dataset-review/__tests__/us3_execution_batch.ux.test.js b/frontend/src/lib/components/dataset-review/__tests__/us3_execution_batch.ux.test.js
index cba31f68..02b48eb5 100644
--- a/frontend/src/lib/components/dataset-review/__tests__/us3_execution_batch.ux.test.js
+++ b/frontend/src/lib/components/dataset-review/__tests__/us3_execution_batch.ux.test.js
@@ -7,9 +7,9 @@
 // @SEMANTICS: dataset-review, execution, mapping, preview, launch, ux-tests
 // @PURPOSE: Verify US3 mapping review, Superset preview, and launch confirmation UX contracts.
 // @LAYER: UI
-// @RELATION: [VERIFIES] ->[ExecutionMappingReview]
-// @RELATION: [VERIFIES] ->[CompiledSQLPreview]
-// @RELATION: [VERIFIES] ->[LaunchConfirmationPanel]
+// @RELATION: DEPENDS_ON -> [ExecutionMappingReview]
+// @RELATION: DEPENDS_ON -> [CompiledSQLPreview]
+// @RELATION: DEPENDS_ON -> [LaunchConfirmationPanel]
 // @UX_STATE: WarningApproval -> Mapping review requires explicit approval or manual override.
 // @UX_STATE: Ready -> Preview and launch panels expose reviewed Superset-backed execution context.
 // @UX_STATE: Blocked -> Launch panel lists blockers instead of allowing hidden bypass.
@@ -24,13 +24,13 @@
 
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { fireEvent, render, screen, waitFor } from "@testing-library/svelte";
-import { requestApi } from "$lib/api.js";
+import { requestDatasetReviewApi } from "$lib/api/datasetReview.js";
 import ExecutionMappingReview from "../ExecutionMappingReview.svelte";
 import CompiledSQLPreview from "../CompiledSQLPreview.svelte";
 import LaunchConfirmationPanel from "../LaunchConfirmationPanel.svelte";
 
-vi.mock("$lib/api.js", () => ({
-  requestApi: vi.fn(),
+vi.mock("$lib/api/datasetReview.js", () => ({
+  requestDatasetReviewApi: vi.fn(),
 }));
 
 vi.mock("$lib/i18n", () => ({
@@ -192,11 +192,11 @@ vi.mock("$lib/i18n", () => ({
 
 describe("Dataset review US3 execution UX", () => {
   beforeEach(() => {
-    requestApi.mockReset();
+    requestDatasetReviewApi.mockReset();
   });
 
   it("mapping_review_approves_warning_sensitive_row", async () => {
-    requestApi.mockResolvedValueOnce({
+    requestDatasetReviewApi.mockResolvedValueOnce({
       mapping_id: "map-1",
       filter_id: "filter-1",
       variable_id: "var-1",
@@ -257,10 +257,11 @@ describe("Dataset review US3 execution UX", () => {
     await fireEvent.click(screen.getByRole("button", { name: "Approve mapping" }));
 
     await waitFor(() => {
-      expect(requestApi).toHaveBeenCalledWith(
+      expect(requestDatasetReviewApi).toHaveBeenCalledWith(
         "/dataset-orchestration/sessions/session-1/mappings/map-1/approve",
         "POST",
         { approval_note: "Trimmed imported value" },
+        null,
       );
     });
 
@@ -275,7 +276,7 @@ describe("Dataset review US3 execution UX", () => {
   });
 
   it("mapping_review_batch_approves_pending_rows", async () => {
-    requestApi.mockResolvedValueOnce([
+    requestDatasetReviewApi.mockResolvedValueOnce([
       {
         mapping_id: "map-1",
         filter_id: "filter-1",
@@ -333,10 +334,11 @@ describe("Dataset review US3 execution UX", () => {
     await fireEvent.click(screen.getByRole("button", { name: "Approve all pending mappings" }));
 
     await waitFor(() => {
-      expect(requestApi).toHaveBeenCalledWith(
+      expect(requestDatasetReviewApi).toHaveBeenCalledWith(
         "/dataset-orchestration/sessions/session-1/mappings/approve-batch",
         "POST",
         { mapping_ids: ["map-1"] },
+        null,
       );
     });
 
@@ -347,7 +349,7 @@ describe("Dataset review US3 execution UX", () => {
   });
 
   it("preview_panel_requests_superset_compilation_and_renders_sql", async () => {
-    requestApi.mockResolvedValueOnce({
+    requestDatasetReviewApi.mockResolvedValueOnce({
       preview_id: "preview-1",
       session_id: "session-1",
       preview_status: "ready",
@@ -372,21 +374,25 @@ describe("Dataset review US3 execution UX", () => {
     await fireEvent.click(screen.getByRole("button", { name: "Generate SQL preview" }));
 
     await waitFor(() => {
-      expect(requestApi).toHaveBeenCalledWith(
+      expect(requestDatasetReviewApi).toHaveBeenCalledWith(
         "/dataset-orchestration/sessions/session-1/preview",
         "POST",
+        null,
+        null,
       );
     });
 
-    expect(onupdated).toHaveBeenCalledWith({
-      preview: expect.objectContaining({
-        preview_id: "preview-1",
-        compiled_by: "superset",
-      }),
-      preview_state: "ready",
+    await waitFor(() => {
+      expect(onupdated).toHaveBeenCalledWith({
+        preview: expect.objectContaining({
+          preview_id: "preview-1",
+          compiled_by: "superset",
+        }),
+        preview_state: "ready",
+      });
     });
 
-    requestApi.mockRejectedValueOnce(new Error("Superset compile failed"));
+    requestDatasetReviewApi.mockRejectedValueOnce(new Error("Superset compile failed"));
 
     const onjump = vi.fn();
     render(CompiledSQLPreview, {
@@ -446,7 +452,7 @@ describe("Dataset review US3 execution UX", () => {
     await fireEvent.click(screen.getAllByRole("button", { name: "Open related area" })[1]);
     expect(onjump).toHaveBeenCalledWith({ target: "mapping" });
 
-    requestApi.mockResolvedValueOnce({
+    requestDatasetReviewApi.mockResolvedValueOnce({
       run_context: {
         run_context_id: "run-1",
         sql_lab_session_ref: "sql-lab-77",
@@ -487,13 +493,15 @@ describe("Dataset review US3 execution UX", () => {
     await fireEvent.click(screen.getByRole("button", { name: "Launch dataset" }));
 
     await waitFor(() => {
-      expect(requestApi).toHaveBeenCalledWith(
+      expect(requestDatasetReviewApi).toHaveBeenCalledWith(
         "/dataset-orchestration/sessions/session-1/launch",
         "POST",
+        null,
+        null,
       );
     });
 
     expect(screen.getByText("Dataset launch request sent to SQL Lab.")).toBeDefined();
   });
 });
-// [/DEF:DatasetReviewUs3UxTests:Module]
\ No newline at end of file
+// [/DEF:DatasetReviewUs3UxTests:Module]
diff --git a/frontend/src/lib/components/dataset-review/__tests__/validation_findings_panel.ux.test.js b/frontend/src/lib/components/dataset-review/__tests__/validation_findings_panel.ux.test.js
index 91baa31b..97bbf98f 100644
--- a/frontend/src/lib/components/dataset-review/__tests__/validation_findings_panel.ux.test.js
+++ b/frontend/src/lib/components/dataset-review/__tests__/validation_findings_panel.ux.test.js
@@ -6,7 +6,7 @@
 // @SEMANTICS: dataset-review, findings, severity, jump, ux-tests
 // @PURPOSE: Verify grouped findings visibility, empty state, and remediation jump behavior for US1.
 // @LAYER: UI
-// @RELATION: [VERIFIES] ->[ValidationFindingsPanel]
+// @RELATION: DEPENDS_ON -> [ValidationFindingsPanel]
 // @UX_STATE: Blocking -> Blocking findings dominate the panel and expose remediation jumps.
 // @UX_STATE: Warning -> Warning findings remain visible with explicit resolution state.
 // @UX_STATE: Informational -> Informational notes stay readable without competing with blockers.
@@ -138,4 +138,4 @@ describe("ValidationFindingsPanel UX Contract", () => {
     expect(screen.getByText("No findings")).toBeDefined();
   });
 });
-// [/DEF:ValidationFindingsPanelUxTests:Module]
\ No newline at end of file
+// [/DEF:ValidationFindingsPanelUxTests:Module]
diff --git a/frontend/src/lib/components/health/HealthMatrix.svelte b/frontend/src/lib/components/health/HealthMatrix.svelte
index e4d045fd..49337bf0 100644
--- a/frontend/src/lib/components/health/HealthMatrix.svelte
+++ b/frontend/src/lib/components/health/HealthMatrix.svelte
@@ -1,14 +1,14 @@
 <!-- [DEF:HealthMatrix:Component] -->
 <!--
-@RELATION: USES -> App
- 
-  @COMPLEXITY: 3
-  @PURPOSE: Visual grid/matrix representing the health status of dashboards.
-  @LAYER: UI/Component
-  @UX_STATE: Idle -> Displays the health matrix grid.
-  @UX_STATE: Loading -> Displays a skeleton or spinner.
-  @UX_STATE: Error -> Displays an error message with a retry option.
-  @UX_REATIVITY: State: $state, Derived: $derived.
+@COMPLEXITY: 3
+@PURPOSE: Visual grid summary representing dashboard health status counts.
+@LAYER: UI
+@RELATION: BINDS_TO -> i18n
+
+@UX_STATE: Idle -> Displays the health matrix grid.
+@UX_STATE: Loading -> Displays a skeleton or spinner.
+@UX_STATE: Error -> Displays an error message with a retry option.
+@UX_REACTIVITY: Uses $derived to keep aggregate totals consistent with the count props.
 -->
 <script>
   import { t } from '$lib/i18n';
diff --git a/frontend/src/lib/components/health/PolicyForm.svelte b/frontend/src/lib/components/health/PolicyForm.svelte
index c0d3d790..16d274b0 100644
--- a/frontend/src/lib/components/health/PolicyForm.svelte
+++ b/frontend/src/lib/components/health/PolicyForm.svelte
@@ -1,15 +1,16 @@
 <!-- [DEF:PolicyForm:Component] -->
 <!--
-@RELATION: USES -> App
- 
-  @COMPLEXITY: 3
-  @PURPOSE: Form for creating and editing validation policies.
-  @LAYER: UI/Component
-  @UX_STATE: Idle -> Displays the policy form.
-  @UX_STATE: Submitting -> Disables inputs and shows a loading state.
-  @UX_FEEDBACK: Success -> Shows a success toast and closes the form.
-  @UX_FEEDBACK: Error -> Shows error messages on invalid fields.
-  @UX_REATIVITY: State: $state, Derived: $derived.
+@COMPLEXITY: 3
+@PURPOSE: Form for creating and editing validation policies.
+@LAYER: UI
+@RELATION: DISPATCHES -> onSave
+@RELATION: DISPATCHES -> onCancel
+
+@UX_STATE: Idle -> Displays the policy form.
+@UX_STATE: Submitting -> Disables inputs and shows a loading state.
+@UX_FEEDBACK: Success -> Parent flow can close the form after a successful save.
+@UX_FEEDBACK: Error -> Invalid field or submit failures keep the draft visible for correction.
+@UX_REACTIVITY: Uses $state for mutable form data and $derived values for window health checks.
 -->
 <script>
   /** @type {{ policy: any, environments: any[], onSave: (p: any) => void, onCancel: () => void }} */
@@ -194,4 +195,4 @@
     </button>
   </div>
 </form>
-<!-- [/DEF:PolicyForm:Component] -->
\ No newline at end of file
+<!-- [/DEF:PolicyForm:Component] -->
diff --git a/frontend/src/lib/components/layout/Breadcrumbs.svelte b/frontend/src/lib/components/layout/Breadcrumbs.svelte
index a37e7ae0..52ef260d 100644
--- a/frontend/src/lib/components/layout/Breadcrumbs.svelte
+++ b/frontend/src/lib/components/layout/Breadcrumbs.svelte
@@ -2,12 +2,14 @@
 <script>
   /**
    * @COMPLEXITY: 3
-   * @PURPOSE: Display page hierarchy navigation
+   * @PURPOSE: Display page hierarchy navigation.
    * @LAYER: UI
-    * @RELATION: DEPENDS_ON -> page
-   * @INVARIANT: Always shows current page path
+   * @RELATION: BINDS_TO -> [i18n]
+   * @RELATION: DEPENDS_ON -> [Icon]
+   * @INVARIANT: Always shows current page path.
    *
    * @UX_STATE: Idle -> Breadcrumbs showing current path
+   * @UX_STATE: Collapsed -> Intermediate segments collapse into an ellipsis when the path exceeds the visibility budget.
    * @UX_FEEDBACK: Hover on breadcrumb shows clickable state
    * @UX_RECOVERY: Click breadcrumb to navigate
    */
diff --git a/frontend/src/lib/components/layout/Sidebar.svelte b/frontend/src/lib/components/layout/Sidebar.svelte
index d51ec3b2..edae0b7d 100644
--- a/frontend/src/lib/components/layout/Sidebar.svelte
+++ b/frontend/src/lib/components/layout/Sidebar.svelte
@@ -4,12 +4,22 @@
    * @COMPLEXITY: 5
    * @PURPOSE: Persistent left sidebar with resource categories navigation
    * @LAYER: UI
-    * @RELATION: BINDS_TO -> sidebar
+   * @RELATION: BINDS_TO -> sidebar
+   * @RELATION: BINDS_TO -> auth
+   * @RELATION: BINDS_TO -> health_store
+   * @RELATION: DEPENDS_ON -> SidebarNavigation
+   * @RELATION: DEPENDS_ON -> Icon
    * @SEMANTICS: Navigation
+   * @PRE: Sidebar store and translated category definitions are available before navigation is rendered.
+   * @POST: Active category and item remain aligned with the current route and mobile state is dismissible.
+   * @SIDE_EFFECT: Persists sidebar state via store actions, refreshes health indicators, and updates window location on navigation.
+   * @DATA_CONTRACT: SidebarCategory[] -> RenderedNavigationTree
    * @INVARIANT: Always shows active category and item
+   * @UX_REACTIVITY: Uses $derived for store-backed navigation state and $effect guards for route/category coherence.
    *
    * @UX_STATE: Idle -> Sidebar visible with current state
    * @UX_STATE: Toggling -> Animation plays for 200ms
+   * @UX_STATE: MobileOpen -> Overlay and sidebar stay visible on small screens until dismissed.
    * @UX_FEEDBACK: Active item highlighted with different background
    * @UX_RECOVERY: Click outside on mobile closes overlay
    *
diff --git a/frontend/src/lib/components/layout/TaskDrawer.svelte b/frontend/src/lib/components/layout/TaskDrawer.svelte
index 1c7aa46d..f019df2e 100644
--- a/frontend/src/lib/components/layout/TaskDrawer.svelte
+++ b/frontend/src/lib/components/layout/TaskDrawer.svelte
@@ -4,13 +4,18 @@
    * @COMPLEXITY: 5
    * @PURPOSE: Global task drawer for monitoring background operations
    * @LAYER: UI
-    * @RELATION: BINDS_TO -> taskDrawer
+   * @RELATION: BINDS_TO -> taskDrawer
    * @SEMANTICS: TaskLogViewer
-   * @INVARIANT: Drawer shows logs for active task or remains closed
-   *
-   * @UX_STATE: Closed -> Drawer hidden, no active task
-   * @UX_STATE: Open/ListMode -> Drawer visible, showing recent tasks list
-   * @UX_STATE: Open/TaskDetail -> Drawer visible, showing logs for selected task
+   * @PRE: Task drawer store and optional websocket task context are available before detail mode is requested.
+   * @POST: Drawer stays closed, shows the recent-task list, or renders a selected task detail without losing task context.
+   * @SIDE_EFFECT: Opens websocket streams, loads recent tasks, and mutates drawer selection state.
+   * @DATA_CONTRACT: TaskDrawerState -> RecentTaskList | ActiveTaskDetail
+    * @INVARIANT: Drawer shows logs for active task or remains closed
+   * @UX_REACTIVITY: Uses $state for local drawer UI and $derived or store subscriptions for active task synchronization.
+    *
+    * @UX_STATE: Closed -> Drawer hidden, no active task
+    * @UX_STATE: Open/ListMode -> Drawer visible, showing recent tasks list
+    * @UX_STATE: Open/TaskDetail -> Drawer visible, showing logs for selected task
    * @UX_STATE: InputRequired -> Interactive form rendered in drawer
    * @UX_FEEDBACK: Close button allows task to continue running
    * @UX_FEEDBACK: Back button returns to task list
diff --git a/frontend/src/lib/components/layout/TopNavbar.svelte b/frontend/src/lib/components/layout/TopNavbar.svelte
index 64bc9664..2eea3cc5 100644
--- a/frontend/src/lib/components/layout/TopNavbar.svelte
+++ b/frontend/src/lib/components/layout/TopNavbar.svelte
@@ -4,12 +4,24 @@
    * @COMPLEXITY: 5
    * @PURPOSE: Unified top navigation bar with Logo, Search, Activity, and User menu
    * @LAYER: UI
-    * @RELATION: BINDS_TO -> activity
+   * @RELATION: BINDS_TO -> activity
+   * @RELATION: BINDS_TO -> auth
+   * @RELATION: BINDS_TO -> environmentContext
+   * @RELATION: DISPATCHES -> taskDrawer
+   * @RELATION: DISPATCHES -> assistantChat
+   * @RELATION: DEPENDS_ON -> Icon
+   * @RELATION: DEPENDS_ON -> LanguageSwitcher
    * @SEMANTICS: Navigation, UserSession
+   * @PRE: Auth, environment, and task stores are initialized before interactive navbar actions are used.
+   * @POST: Search, environment selection, and global action controls remain synchronized with current app state.
+   * @SIDE_EFFECT: Reads profile preferences, performs search API requests, and triggers drawer, auth, and assistant actions.
+   * @DATA_CONTRACT: SearchQuery -> SearchSection[] | ProfilePreferences -> TaskDrawerPreference
    * @INVARIANT: Always visible on non-login pages
+   * @UX_REACTIVITY: Uses $state for menu/search state and $derived projections from app stores.
    *
    * @UX_STATE: Idle -> Navbar showing current state
    * @UX_STATE: SearchFocused -> Search input expands
+   * @UX_STATE: Searching -> Search dropdown stays open while async results are loading.
    * @UX_FEEDBACK: Activity badge shows count of running tasks
    * @UX_RECOVERY: Click outside closes dropdowns
    * @UX_TEST: SearchFocused -> {focus: search input, expected: focused style class applied}
diff --git a/frontend/src/lib/components/layout/__tests__/sidebarNavigation.test.js b/frontend/src/lib/components/layout/__tests__/sidebarNavigation.test.js
index e5b3b9c3..06420075 100644
--- a/frontend/src/lib/components/layout/__tests__/sidebarNavigation.test.js
+++ b/frontend/src/lib/components/layout/__tests__/sidebarNavigation.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, sidebar, navigation, rbac, permissions
 // @PURPOSE: Verifies RBAC-based sidebar category and subitem visibility.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> frontend/src/lib/components/layout/sidebarNavigation.js
+// @RELATION: DEPENDS_ON -> [SidebarNavigation]
 
 import { describe, it, expect } from "vitest";
 import { buildSidebarCategories } from "../sidebarNavigation.js";
@@ -96,4 +96,4 @@ describe("sidebarNavigation", () => {
   });
 });
 
-// [/DEF:frontend.src.lib.components.layout.__tests__.sidebarNavigation:Module]
\ No newline at end of file
+// [/DEF:SidebarNavigationTest:Module]
diff --git a/frontend/src/lib/components/layout/__tests__/test_breadcrumbs.svelte.js b/frontend/src/lib/components/layout/__tests__/test_breadcrumbs.svelte.js
index d10d789f..c670a6a3 100644
--- a/frontend/src/lib/components/layout/__tests__/test_breadcrumbs.svelte.js
+++ b/frontend/src/lib/components/layout/__tests__/test_breadcrumbs.svelte.js
@@ -1,9 +1,9 @@
-// [DEF:__tests__/test_breadcrumbs:Module]
+// [DEF:BreadcrumbsContractTest:Module]
 // @UX_STATE: Loading -> Default
 // @COMPLEXITY: 3
 // @PURPOSE: Contract-focused unit tests for Breadcrumbs.svelte logic and UX annotations
 // @LAYER: UI
-// @RELATION: VERIFIES -> Breadcrumbs
+// @RELATION: DEPENDS_ON -> [Breadcrumbs]
 
 import { describe, it, expect } from 'vitest';
 import fs from 'node:fs';
@@ -66,14 +66,15 @@ function formatBreadcrumbLabel(segment) {
 }
 
 describe('Breadcrumbs Component Contract & Logic', () => {
-  it('contains required UX tags and semantic header for STANDARD module', () => {
+  it('contains required UX tags and current dependency contract', () => {
     const source = fs.readFileSync(COMPONENT_PATH, 'utf-8');
 
     expect(source).toContain('@COMPLEXITY: 3');
     expect(source).toContain('@UX_STATE: Idle');
     expect(source).toContain('@UX_FEEDBACK');
     expect(source).toContain('@UX_RECOVERY');
-    expect(source).toContain('@RELATION: DEPENDS_ON -> PageStore');
+    expect(source).toContain('@RELATION: BINDS_TO -> [i18n]');
+    expect(source).toContain('import { page } from "$app/state"');
   });
 
   it('returns Home for root path (Short-Path UX state)', () => {
@@ -103,4 +104,4 @@ describe('Breadcrumbs Component Contract & Logic', () => {
   });
 });
 
-// [/DEF:__tests__/test_breadcrumbs:Module]
\ No newline at end of file
+// [/DEF:BreadcrumbsContractTest:Module]
diff --git a/frontend/src/lib/components/layout/__tests__/test_sidebar.svelte.js b/frontend/src/lib/components/layout/__tests__/test_sidebar.svelte.js
index 2c79546d..9bb26f56 100644
--- a/frontend/src/lib/components/layout/__tests__/test_sidebar.svelte.js
+++ b/frontend/src/lib/components/layout/__tests__/test_sidebar.svelte.js
@@ -1,9 +1,9 @@
-// [DEF:__tests__/test_sidebar:Module]
+// [DEF:SidebarStoreTest:Module]
 // @UX_STATE: Loading -> Default
 // @COMPLEXITY: 3
 // @PURPOSE: Unit tests for Sidebar.svelte component
 // @LAYER: UI
-// @RELATION: VERIFIES -> Sidebar
+// @RELATION: DEPENDS_ON -> [Sidebar]
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 
@@ -233,4 +233,4 @@ describe('Sidebar Component', () => {
   });
 });
 
-// [/DEF:__tests__/test_sidebar:Module]
\ No newline at end of file
+// [/DEF:SidebarStoreTest:Module]
diff --git a/frontend/src/lib/components/layout/__tests__/test_taskDrawer.svelte.js b/frontend/src/lib/components/layout/__tests__/test_taskDrawer.svelte.js
index 310447f2..fdbb7a03 100644
--- a/frontend/src/lib/components/layout/__tests__/test_taskDrawer.svelte.js
+++ b/frontend/src/lib/components/layout/__tests__/test_taskDrawer.svelte.js
@@ -1,9 +1,9 @@
-// [DEF:__tests__/test_taskDrawer:Module]
+// [DEF:TaskDrawerStoreTest:Module]
 // @UX_STATE: Loading -> Default
 // @COMPLEXITY: 3
 // @PURPOSE: Unit tests for TaskDrawer.svelte component
 // @LAYER: UI
-// @RELATION: VERIFIES -> TaskDrawer
+// @RELATION: DEPENDS_ON -> [TaskDrawer]
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 
@@ -245,4 +245,4 @@ describe('TaskDrawer Component Store Tests', () => {
   });
 });
 
-// [/DEF:__tests__/test_taskDrawer:Module]
\ No newline at end of file
+// [/DEF:TaskDrawerStoreTest:Module]
diff --git a/frontend/src/lib/components/layout/__tests__/test_topNavbar.svelte.js b/frontend/src/lib/components/layout/__tests__/test_topNavbar.svelte.js
index b2fc4463..4d87a1db 100644
--- a/frontend/src/lib/components/layout/__tests__/test_topNavbar.svelte.js
+++ b/frontend/src/lib/components/layout/__tests__/test_topNavbar.svelte.js
@@ -1,9 +1,9 @@
-// [DEF:__tests__/test_topNavbar:Module]
+// [DEF:TopNavbarStoreTest:Module]
 // @UX_STATE: Loading -> Default
 // @COMPLEXITY: 3
 // @PURPOSE: Unit tests for TopNavbar.svelte component
 // @LAYER: UI
-// @RELATION: VERIFIES -> TopNavbar
+// @RELATION: DEPENDS_ON -> [TopNavbar]
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 
@@ -188,4 +188,4 @@ describe('TopNavbar Component Store Tests', () => {
   });
 });
 
-// [/DEF:__tests__/test_topNavbar:Module]
\ No newline at end of file
+// [/DEF:TopNavbarStoreTest:Module]
diff --git a/frontend/src/lib/components/reports/__tests__/report_card.ux.test.js b/frontend/src/lib/components/reports/__tests__/report_card.ux.test.js
index a53e1df9..8fe6699a 100644
--- a/frontend/src/lib/components/reports/__tests__/report_card.ux.test.js
+++ b/frontend/src/lib/components/reports/__tests__/report_card.ux.test.js
@@ -6,7 +6,7 @@
 // @SEMANTICS: reports, ux-tests, card, states, recovery
 // @PURPOSE: Test UX states and transitions for ReportCard component
 // @LAYER: UI
-// @RELATION: VERIFIES -> ../ReportCard.svelte
+// @RELATION: DEPENDS_ON -> [ReportCard]
 // @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.
@@ -78,7 +78,7 @@ describe('ReportCard UX Contract', () => {
     expect(screen.getByText('reports.unknown_type')).toBeDefined();
   });
 
-  // @TEST_FIXTURE valid_report_card
+// @TEST_FIXTURE: valid_report_card -> INLINE_JSON
   it('should render valid_report_card correctly', () => {
     const validReportCard = {
       task_type: "migration",
@@ -92,18 +92,18 @@ describe('ReportCard UX Contract', () => {
     expect(screen.getByText('Success')).toBeDefined();
   });
 
-  // @TEST_EDGE empty_report_object
+// @TEST_EDGE: empty_report_object -> Missing fields use placeholders and fallback labels.
   it('should handle completely empty report object gracefully', () => {
     render(ReportCard, { report: {}, onselect: vi.fn() });
     const placeholders = screen.getAllByText('Not provided');
     expect(placeholders.length).toBeGreaterThan(0);
   });
 
-  // @TEST_EDGE random_status
+// @TEST_EDGE: random_status -> Unknown status is rendered without crashing.
   it('should render random status directly if no translation matches', () => {
     render(ReportCard, { report: { status: "unknown_status_code" }, onselect: vi.fn() });
     expect(screen.getByText('unknown_status_code')).toBeDefined();
   });
 });
 
-// [/DEF:frontend.src.lib.components.reports.__tests__.report_card.ux:Module]
\ No newline at end of file
+// [/DEF:ReportCardTest:Module]
diff --git a/frontend/src/lib/components/reports/__tests__/report_detail.integration.test.js b/frontend/src/lib/components/reports/__tests__/report_detail.integration.test.js
index 232ed8ea..393b4a7f 100644
--- a/frontend/src/lib/components/reports/__tests__/report_detail.integration.test.js
+++ b/frontend/src/lib/components/reports/__tests__/report_detail.integration.test.js
@@ -3,8 +3,8 @@
 // @SEMANTICS: tests, reports, detail, recovery-guidance, integration
 // @PURPOSE: Validate detail-panel behavior for failed reports and recovery guidance visibility.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> frontend/src/lib/components/reports/ReportDetailPanel.svelte
-// @RELATION: TESTS -> frontend/src/routes/reports/+page.svelte
+// @RELATION: DEPENDS_ON -> [ReportDetailPanel]
+// @RELATION: DEPENDS_ON -> [UnifiedReportsPage]
 // @INVARIANT: Failed report detail exposes actionable next actions when available.
 
 import { describe, it, expect } from 'vitest';
@@ -42,4 +42,4 @@ describe('report detail integration - failed report guidance', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.components.reports.__tests__.report_detail.integration:Module]
\ No newline at end of file
+// [/DEF:ReportDetailIntegrationTest:Module]
diff --git a/frontend/src/lib/components/reports/__tests__/report_detail.ux.test.js b/frontend/src/lib/components/reports/__tests__/report_detail.ux.test.js
index 4f64917e..7003fc0d 100644
--- a/frontend/src/lib/components/reports/__tests__/report_detail.ux.test.js
+++ b/frontend/src/lib/components/reports/__tests__/report_detail.ux.test.js
@@ -6,7 +6,7 @@
 // @SEMANTICS: reports, ux-tests, detail, diagnostics, recovery
 // @PURPOSE: Test UX states and recovery for ReportDetailPanel component
 // @LAYER: UI
-// @RELATION: VERIFIES -> ../ReportDetailPanel.svelte
+// @RELATION: DEPENDS_ON -> [ReportDetailPanel]
 // @INVARIANT: Detail UX tests keep placeholder-safe rendering and recovery visibility verifiable.
 
 import { describe, it, expect, vi } from 'vitest';
@@ -71,4 +71,4 @@ describe('ReportDetailPanel UX Contract', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.components.reports.__tests__.report_detail.ux:Module]
\ No newline at end of file
+// [/DEF:ReportDetailUxTest:Module]
diff --git a/frontend/src/lib/components/reports/__tests__/report_type_profiles.test.js b/frontend/src/lib/components/reports/__tests__/report_type_profiles.test.js
index 40afe6de..acd35273 100644
--- a/frontend/src/lib/components/reports/__tests__/report_type_profiles.test.js
+++ b/frontend/src/lib/components/reports/__tests__/report_type_profiles.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, reports, type-profiles, fallback
 // @PURPOSE: Validate report type profile mapping and unknown fallback behavior.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> ReportTypeProfiles
+// @RELATION: DEPENDS_ON -> [ReportTypeProfiles]
 // @INVARIANT: Unknown task_type always resolves to the fallback profile.
 
 import { describe, it, expect } from 'vitest';
@@ -29,4 +29,4 @@ describe('report type profiles', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.components.reports.__tests__.report_type_profiles:Module]
\ No newline at end of file
+// [/DEF:ReportTypeProfilesTest:Module]
diff --git a/frontend/src/lib/components/reports/__tests__/reports_filter_performance.test.js b/frontend/src/lib/components/reports/__tests__/reports_filter_performance.test.js
index 1df8719f..ccb10dd5 100644
--- a/frontend/src/lib/components/reports/__tests__/reports_filter_performance.test.js
+++ b/frontend/src/lib/components/reports/__tests__/reports_filter_performance.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, reports, performance, filtering
 // @PURPOSE: Guard test for report filter responsiveness on moderate in-memory dataset.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> frontend/src/routes/reports/+page.svelte
+// @RELATION: DEPENDS_ON -> [UnifiedReportsPage]
 
 import { describe, it, expect } from 'vitest';
 
@@ -45,4 +45,4 @@ describe('reports filter performance guard', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.components.reports.__tests__.reports_filter_performance:Module]
\ No newline at end of file
+// [/DEF:ReportsFilterPerformanceTest:Module]
diff --git a/frontend/src/lib/components/reports/__tests__/reports_list.ux.test.js b/frontend/src/lib/components/reports/__tests__/reports_list.ux.test.js
index eda3e313..d5e8a46d 100644
--- a/frontend/src/lib/components/reports/__tests__/reports_list.ux.test.js
+++ b/frontend/src/lib/components/reports/__tests__/reports_list.ux.test.js
@@ -6,8 +6,13 @@
 // @SEMANTICS: reports, list, ux-tests, events, iteration
 // @PURPOSE: Test ReportsList component iteration and event forwarding.
 // @LAYER: UI
-// @RELATION: VERIFIES -> ../ReportsList.svelte
-// [/DEF:frontend.src.lib.components.reports.__tests__.reports_list.ux:Module]
+// @RELATION: DEPENDS_ON -> [ReportsList]
+// @TEST_CONTRACT: ReportsListProps -> rendered cards and forwarded select events
+// @TEST_SCENARIO: renders_report_cards_for_each_item -> Each report becomes one rendered selectable card.
+// @TEST_SCENARIO: renders_empty_list_container -> Empty input keeps stable container without child cards.
+// @TEST_SCENARIO: forwards_select_event -> Child click forwards select payload to parent listener.
+// @TEST_FIXTURE: reports_list_examples -> INLINE_JSON
+// @TEST_INVARIANT: report_iteration_and_select_contract -> VERIFIED_BY: [renders_report_cards_for_each_item, renders_empty_list_container, forwards_select_event]
 
 import { describe, it, expect, vi } from 'vitest';
 import { render, screen, fireEvent } from '@testing-library/svelte';
@@ -36,7 +41,7 @@ describe('ReportsList UX Contract', () => {
         { report_id: '2', summary: 'Report Two', task_type: 'backup', status: 'failed' }
     ];
 
-    // @TEST_FIXTURE renders_list
+    // @TEST_FIXTURE: renders_list -> INLINE_JSON
     it('should render multiple report cards and mark the selected one', () => {
         const { container } = render(ReportsList, { reports: mockReports, selectedReportId: '2' });
 
@@ -49,8 +54,8 @@ describe('ReportsList UX Contract', () => {
         expect(buttons.length).toBe(2);
     });
 
-    // @TEST_EDGE empty_list
-    // @TEST_INVARIANT correct_iteration
+    // @TEST_EDGE: empty_list -> Empty reports array keeps container stable.
+    // @TEST_INVARIANT: correct_iteration -> VERIFIED_BY: [renders_report_cards_for_each_item, renders_empty_list_container]
     it('should render empty container for empty list', () => {
         const { container } = render(ReportsList, { reports: [] });
         // Root div should have space-y-2 class but be empty
@@ -60,7 +65,7 @@ describe('ReportsList UX Contract', () => {
     });
 
     // @UX_FEEDBACK: Click on report emits select event.
-    // @TEST_CONTRACT Component_ReportsList -> Forwards select events from children
+    // @TEST_CONTRACT: Component_ReportsList -> Forwards select events from children.
     it('should forward select event when a report card is clicked', async () => {
         const onSelect = vi.fn();
         const { component } = render(ReportsList, { reports: [mockReports[0]], onselect: onSelect });
@@ -72,3 +77,4 @@ describe('ReportsList UX Contract', () => {
         expect(onSelect.mock.calls[0][0].report.report_id).toBe('1');
     });
 });
+// [/DEF:ReportsListTest:Module]
diff --git a/frontend/src/lib/components/reports/__tests__/reports_page.integration.test.js b/frontend/src/lib/components/reports/__tests__/reports_page.integration.test.js
index abaf2a9d..be03701b 100644
--- a/frontend/src/lib/components/reports/__tests__/reports_page.integration.test.js
+++ b/frontend/src/lib/components/reports/__tests__/reports_page.integration.test.js
@@ -3,8 +3,8 @@
 // @SEMANTICS: tests, reports, integration, mixed-types, rendering
 // @PURPOSE: Integration-style checks for unified mixed-type reports rendering expectations.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> frontend/src/routes/reports/+page.svelte
-// @RELATION: TESTS -> frontend/src/lib/components/reports/ReportsList.svelte
+// @RELATION: DEPENDS_ON -> [UnifiedReportsPage]
+// @RELATION: DEPENDS_ON -> [ReportsList]
 // @INVARIANT: Mixed fixture includes all supported report types in one list.
 
 import { describe, it, expect } from 'vitest';
@@ -37,4 +37,4 @@ describe('Reports page integration - unified mixed type rendering', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.components.reports.__tests__.reports_page.integration:Module]
\ No newline at end of file
+// [/DEF:ReportsPageTest:Module]
diff --git a/frontend/src/lib/components/reports/reportTypeProfiles.js b/frontend/src/lib/components/reports/reportTypeProfiles.js
index 148336ad..8dba6775 100644
--- a/frontend/src/lib/components/reports/reportTypeProfiles.js
+++ b/frontend/src/lib/components/reports/reportTypeProfiles.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: reports, ui, profiles, fallback, mapping
 // @PURPOSE: Deterministic mapping from report task_type to visual profile with one fallback.
 // @LAYER: UI
-// @RELATION: DEPENDS_ON -> i18n
+// @RELATION: DEPENDS_ON -> [i18n]
 // @INVARIANT: Unknown type always resolves to fallback profile.
 
 import { _ } from '$lib/i18n';
@@ -70,4 +70,4 @@ export function getReportTypeProfile(taskType) {
 }
 // [/DEF:getReportTypeProfile:Function]
 
-// [/DEF:frontend.src.lib.components.reports.reportTypeProfiles:Module]
\ No newline at end of file
+// [/DEF:ReportTypeProfiles:Module]
diff --git a/frontend/src/lib/stores/__tests__/assistantChat.test.js b/frontend/src/lib/stores/__tests__/assistantChat.test.js
index c12ac78f..5188c7b0 100644
--- a/frontend/src/lib/stores/__tests__/assistantChat.test.js
+++ b/frontend/src/lib/stores/__tests__/assistantChat.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: test, store, assistant, toggle, conversation
 // @PURPOSE: Validate assistant chat store visibility and conversation binding transitions.
 // @LAYER: UI Tests
-// @RELATION: DEPENDS_ON -> assistantChatStore
+// @RELATION: DEPENDS_ON -> [assistantChat]
 // @INVARIANT: Each test starts from default closed state.
 
 import { describe, it, expect, beforeEach } from 'vitest';
@@ -20,7 +20,7 @@ import {
 } from '../assistantChat.js';
 
 // [DEF:assistantChatStore_tests:Function]
-// @RELATION: USES -> App
+// @RELATION: BINDS_TO -> [AssistantChatTest]
 // @COMPLEXITY: 3
 // @PURPOSE: Group store unit scenarios for assistant panel behavior.
 // @PRE: Store can be reset to baseline state in beforeEach hook.
@@ -84,4 +84,4 @@ describe('assistantChatStore', () => {
   });
 });
 // [/DEF:assistantChatStore_tests:Function]
-// [/DEF:frontend.src.lib.stores.__tests__.assistantChat:Module]
+// [/DEF:AssistantChatTest:Module]
diff --git a/frontend/src/lib/stores/__tests__/mocks/env_public.js b/frontend/src/lib/stores/__tests__/mocks/env_public.js
index 04d62bcd..341de4ae 100644
--- a/frontend/src/lib/stores/__tests__/mocks/env_public.js
+++ b/frontend/src/lib/stores/__tests__/mocks/env_public.js
@@ -1,5 +1,5 @@
 // [DEF:mock_env_public:Module]
-// @RELATION: USES -> App
+// @RELATION: DEPENDS_ON -> [$env/static/public]
 // @COMPLEXITY: 3
 // @PURPOSE: Mock for $env/static/public SvelteKit module in vitest
 // @LAYER: UI (Tests)
diff --git a/frontend/src/lib/stores/__tests__/mocks/environment.js b/frontend/src/lib/stores/__tests__/mocks/environment.js
index 5ba0ab97..1f9d8339 100644
--- a/frontend/src/lib/stores/__tests__/mocks/environment.js
+++ b/frontend/src/lib/stores/__tests__/mocks/environment.js
@@ -1,8 +1,11 @@
-// [DEF:environment:Mock]
+// [DEF:EnvironmentMock:Module]
+// @COMPLEXITY: 2
 // @PURPOSE: Mock for $app/environment in tests
+// @LAYER: UI (Tests)
+// @RELATION: DEPENDS_ON -> [$app/environment]
 
 export const browser = true;
 export const dev = true;
 export const building = false;
 
-// [/DEF:environment:Mock]
+// [/DEF:EnvironmentMock:Module]
diff --git a/frontend/src/lib/stores/__tests__/mocks/navigation.js b/frontend/src/lib/stores/__tests__/mocks/navigation.js
index a6fbe542..287b3be7 100644
--- a/frontend/src/lib/stores/__tests__/mocks/navigation.js
+++ b/frontend/src/lib/stores/__tests__/mocks/navigation.js
@@ -1,10 +1,10 @@
-// [DEF:navigation:Mock]
+// [DEF:NavigationMock:Module]
 // @COMPLEXITY: 1
 // @SEMANTICS: mock, navigation, sveltekit-v1-legacy-surface
 // @PURPOSE: Mock for $app/navigation in tests
 // @INVARIANT: Includes SvelteKit v1-only APIs (push, prefetchRoutes) as compatibility surface for legacy test consumers; keep until all imports migrate to SvelteKit v2-compatible mocks.
 // @RELATION: DEPENDS_ON -> [$app/navigation]
-// @RELATION: BINDS_TO -> [FrontendStoreLegacyNavigationTests]
+// @RELATION: BINDS_TO -> [setupTests]
 
 export const goto = () => Promise.resolve();
 export const push = () => Promise.resolve();
@@ -12,4 +12,4 @@ export const replace = () => Promise.resolve();
 export const prefetch = () => Promise.resolve();
 export const prefetchRoutes = () => Promise.resolve();
 
-// [/DEF:navigation:Mock]
+// [/DEF:NavigationMock:Module]
diff --git a/frontend/src/lib/stores/__tests__/mocks/stores.js b/frontend/src/lib/stores/__tests__/mocks/stores.js
index 9094e40e..2e53df39 100644
--- a/frontend/src/lib/stores/__tests__/mocks/stores.js
+++ b/frontend/src/lib/stores/__tests__/mocks/stores.js
@@ -1,10 +1,10 @@
-// [DEF:stores:Mock]
+// [DEF:StoresMock:Module]
 // @COMPLEXITY: 1
 // @SEMANTICS: mock, stores, sveltekit-v1-legacy-surface
 // @PURPOSE: Mock for $app/stores in tests
 // @INVARIANT: Mocks $app/stores which is a SvelteKit v1 module; SvelteKit v2 uses $app/state. Verify no active test files import this mock before removal.
 // @RELATION: DEPENDS_ON -> [$app/stores]
-// @RELATION: BINDS_TO -> [FrontendStoreLegacyStateTests]
+// @RELATION: BINDS_TO -> [setupTests]
 
 import { writable, readable } from 'svelte/store';
 
@@ -25,4 +25,4 @@ export const updated = {
   subscribe: writable(false).subscribe
 };
 
-// [/DEF:stores:Mock]
+// [/DEF:StoresMock:Module]
diff --git a/frontend/src/lib/stores/__tests__/setupTests.js b/frontend/src/lib/stores/__tests__/setupTests.js
index 95f877df..f1801f8d 100644
--- a/frontend/src/lib/stores/__tests__/setupTests.js
+++ b/frontend/src/lib/stores/__tests__/setupTests.js
@@ -1,6 +1,8 @@
 // [DEF:setupTests:Module]
-// @UX_STATE: Loading -> Default
-// @RELATION: USES -> App
+// @UX_STATE: Idle -> Global test environment exposes stable mocked browser services.
+// @RELATION: DEPENDS_ON -> [StoresMock]
+// @RELATION: DEPENDS_ON -> [NavigationMock]
+// @RELATION: DEPENDS_ON -> [EnvironmentMock]
 // @COMPLEXITY: 3
 // @PURPOSE: Global test setup with mocks for SvelteKit modules
 // @LAYER: UI
diff --git a/frontend/src/lib/stores/__tests__/sidebar.test.js b/frontend/src/lib/stores/__tests__/sidebar.test.js
index 28189989..a576ea96 100644
--- a/frontend/src/lib/stores/__tests__/sidebar.test.js
+++ b/frontend/src/lib/stores/__tests__/sidebar.test.js
@@ -1,9 +1,9 @@
-// @RELATION: VERIFIES -> sidebarStore
 // [DEF:SidebarTest:Module]
 // @COMPLEXITY: 3
 // @SEMANTICS: sidebar, store, tests, mobile, navigation
 // @PURPOSE: Unit tests for sidebar store
 // @LAYER: Domain (Tests)
+// @RELATION: DEPENDS_ON -> [sidebar]
 // @INVARIANT: Sidebar store transitions must be deterministic across desktop/mobile toggles.
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
@@ -69,7 +69,7 @@ describe('SidebarStore', () => {
   // [/DEF:test_toggleSidebar:Function]
 
   // [DEF:test_setActiveItem:Function]
-// @PURPOSE: Default purpose
+// @PURPOSE: Verify active-category updates remain deterministic after item selection.
   // @TEST: setActiveItem updates activeCategory and activeItem
   // @PRE: Store is initialized
   // @POST: activeCategory and activeItem are updated
@@ -93,7 +93,7 @@ describe('SidebarStore', () => {
   // [/DEF:test_setActiveItem:Function]
 
   // [DEF:test_mobile_functions:Function]
-// @PURPOSE: Default purpose
+// @PURPOSE: Verify mobile sidebar helpers update open-state transitions predictably.
   // @TEST: Mobile functions correctly update isMobileOpen
   // @PRE: Store is initialized
   // @POST: isMobileOpen is correctly updated
@@ -131,4 +131,4 @@ describe('SidebarStore', () => {
   // [/DEF:test_mobile_functions:Function]
 });
 
-// [/DEF:frontend.src.lib.stores.__tests__.sidebar:Module]
+// [/DEF:SidebarTest:Module]
diff --git a/frontend/src/lib/stores/__tests__/test_activity.js b/frontend/src/lib/stores/__tests__/test_activity.js
index 0cfd0076..df793281 100644
--- a/frontend/src/lib/stores/__tests__/test_activity.js
+++ b/frontend/src/lib/stores/__tests__/test_activity.js
@@ -2,8 +2,8 @@
 // @COMPLEXITY: 3
 // @PURPOSE: Unit tests for activity store
 // @LAYER: UI
-// @RELATION: VERIFIES -> frontend.src.lib.stores.activity
-// @RELATION: DEPENDS_ON -> frontend.src.lib.stores.taskDrawer
+// @RELATION: DEPENDS_ON -> [activity]
+// @RELATION: DEPENDS_ON -> [taskDrawer]
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 
@@ -116,4 +116,4 @@ describe('activity store', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.stores.__tests__.test_activity:Module]
\ No newline at end of file
+// [/DEF:ActivityTest:Module]
diff --git a/frontend/src/lib/stores/__tests__/test_datasetReviewSession.js b/frontend/src/lib/stores/__tests__/test_datasetReviewSession.js
index 136bf82f..e608e4a4 100644
--- a/frontend/src/lib/stores/__tests__/test_datasetReviewSession.js
+++ b/frontend/src/lib/stores/__tests__/test_datasetReviewSession.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: dataset-review, store, session, tests
 // @PURPOSE: Unit tests for dataset review session store.
 // @LAYER: UI
-// @RELATION: VERIFIES -> [datasetReviewSession:Store]
+// @RELATION: DEPENDS_ON -> [datasetReviewSession]
 // @UX_STATE: Idle -> Store helpers are exercised without asynchronous UI transitions.
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
@@ -110,4 +110,4 @@ describe('datasetReviewSession store', () => {
   });
 });
 
-// [/DEF:DatasetReviewSessionStoreTests:Module]
\ No newline at end of file
+// [/DEF:DatasetReviewSessionStoreTests:Module]
diff --git a/frontend/src/lib/stores/__tests__/test_sidebar.js b/frontend/src/lib/stores/__tests__/test_sidebar.js
index 182a7b4a..b8b04862 100644
--- a/frontend/src/lib/stores/__tests__/test_sidebar.js
+++ b/frontend/src/lib/stores/__tests__/test_sidebar.js
@@ -2,7 +2,7 @@
 // @COMPLEXITY: 3
 // @PURPOSE: Unit tests for sidebar store
 // @LAYER: UI
-// @RELATION: VERIFIES -> frontend.src.lib.stores.sidebar
+// @RELATION: DEPENDS_ON -> [sidebar]
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 
@@ -139,4 +139,4 @@ describe('sidebar store', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.stores.__tests__.test_sidebar:Module]
\ No newline at end of file
+// [/DEF:SidebarIntegrationTest:Module]
diff --git a/frontend/src/lib/stores/__tests__/test_taskDrawer.js b/frontend/src/lib/stores/__tests__/test_taskDrawer.js
index b1ee4819..6cf8cf17 100644
--- a/frontend/src/lib/stores/__tests__/test_taskDrawer.js
+++ b/frontend/src/lib/stores/__tests__/test_taskDrawer.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: task-drawer, store, mapping, tests
 // @PURPOSE: Unit tests for task drawer store
 // @LAYER: UI
-// @RELATION: VERIFIES -> frontend.src.lib.stores.taskDrawer
+// @RELATION: DEPENDS_ON -> [taskDrawer]
 // @INVARIANT: Store state transitions remain deterministic for open/close and task-status mapping.
 
 import { describe, it, expect, beforeEach, vi } from 'vitest';
@@ -157,4 +157,4 @@ describe('taskDrawer store', () => {
   });
 });
 
-// [/DEF:frontend.src.lib.stores.__tests__.test_taskDrawer:Module]
\ No newline at end of file
+// [/DEF:TaskDrawerTest:Module]
diff --git a/frontend/src/lib/ui/Button.svelte b/frontend/src/lib/ui/Button.svelte
index 2997ae23..d4baf88c 100644
--- a/frontend/src/lib/ui/Button.svelte
+++ b/frontend/src/lib/ui/Button.svelte
@@ -1,9 +1,13 @@
 <!-- [DEF:Button:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @SEMANTICS: button, ui-atom, interactive
 @PURPOSE:   Standardized button component with variants and loading states.
 @LAYER:     Atom
+@RELATION:  DEPENDS_ON -> Utils
+
+@UX_STATE: Idle -> Button renders with the requested variant and remains interactive.
+@UX_STATE: Loading -> Spinner replaces the leading area and interaction is disabled.
 
 @INVARIANT: Always uses Tailwind for styling.
 @INVARIANT: Supports accessible labels and keyboard navigation.
@@ -23,7 +27,7 @@
     size = 'md',
     isLoading = false,
     disabled = false,
-    type = 'button',
+    type = /** @type {'button' | 'submit' | 'reset'} */ ('button'),
     class: className = '',
     children,
     onclick,
@@ -65,4 +69,4 @@
 </button>
 <!-- [/SECTION: TEMPLATE] -->
 
-<!-- [/DEF:Button:Component] -->
\ No newline at end of file
+<!-- [/DEF:Button:Component] -->
diff --git a/frontend/src/lib/ui/Card.svelte b/frontend/src/lib/ui/Card.svelte
index 5a6e56b2..a841c906 100644
--- a/frontend/src/lib/ui/Card.svelte
+++ b/frontend/src/lib/ui/Card.svelte
@@ -1,9 +1,13 @@
 <!-- [DEF:Card:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @SEMANTICS: card, container, ui-atom
 @PURPOSE:   Standardized container with padding and elevation.
 @LAYER:     Atom
+@RELATION:  DEPENDS_ON -> Utils
+
+@UX_STATE: Bare -> Container renders slot content without a title row.
+@UX_STATE: Titled -> Header row appears above the padded content area.
 -->
 
 <script>
diff --git a/frontend/src/lib/ui/Icon.svelte b/frontend/src/lib/ui/Icon.svelte
index f1be89e1..278dae44 100644
--- a/frontend/src/lib/ui/Icon.svelte
+++ b/frontend/src/lib/ui/Icon.svelte
@@ -1,3 +1,15 @@
+<!-- [DEF:Icon:Component] -->
+<!--
+@COMPLEXITY: 2
+@SEMANTICS: icon, ui-atom, svg
+@PURPOSE:   Render the shared inline SVG icon set with consistent sizing and stroke props.
+@LAYER:     Atom
+
+@UX_STATE: Ready -> Requested icon path set is rendered as a decorative SVG.
+@UX_STATE: Fallback -> Unknown icon names resolve to the dashboard glyph.
+@INVARIANT: Icon output remains aria-hidden because labels belong to the interactive parent.
+-->
+
 <script>
   let {
     name = "circle",
@@ -86,3 +98,4 @@
     <path {d} />
   {/each}
 </svg>
+<!-- [/DEF:Icon:Component] -->
diff --git a/frontend/src/lib/ui/Input.svelte b/frontend/src/lib/ui/Input.svelte
index f4de1387..06c73796 100644
--- a/frontend/src/lib/ui/Input.svelte
+++ b/frontend/src/lib/ui/Input.svelte
@@ -1,9 +1,14 @@
 <!-- [DEF:Input:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @SEMANTICS: input, form-field, ui-atom
 @PURPOSE:   Standardized text input component with label and error handling.
 @LAYER:     Atom
+@RELATION:  DEPENDS_ON -> Utils
+
+@UX_STATE: Idle -> Input accepts bound text with optional label.
+@UX_STATE: Error -> Inline validation message is rendered beneath the field.
+@UX_STATE: Disabled -> Native disabled state prevents editing while preserving value visibility.
 
 @INVARIANT: Consistent spacing and focus states.
 -->
diff --git a/frontend/src/lib/ui/LanguageSwitcher.svelte b/frontend/src/lib/ui/LanguageSwitcher.svelte
index 9beb80c9..f8912905 100644
--- a/frontend/src/lib/ui/LanguageSwitcher.svelte
+++ b/frontend/src/lib/ui/LanguageSwitcher.svelte
@@ -1,10 +1,14 @@
 <!-- [DEF:LanguageSwitcher:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @SEMANTICS: language-switcher, i18n-ui, ui-atom
 @PURPOSE:   Dropdown component to switch between supported languages.
 @LAYER:     Atom
 @RELATION:  BINDS_TO -> i18n.locale
+@RELATION:  DEPENDS_ON -> Select
+
+@UX_STATE: Idle -> Active locale is shown in the compact selector.
+@UX_STATE: Switching -> Bound locale updates immediately after selection.
 -->
 
 <script>
diff --git a/frontend/src/lib/ui/PageHeader.svelte b/frontend/src/lib/ui/PageHeader.svelte
index 47edbebe..0f464650 100644
--- a/frontend/src/lib/ui/PageHeader.svelte
+++ b/frontend/src/lib/ui/PageHeader.svelte
@@ -1,9 +1,13 @@
 <!-- [DEF:PageHeader:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @SEMANTICS: page-header, layout-atom
 @PURPOSE:   Standardized page header with title and action area.
 @LAYER:     Atom
+@RELATION:  DEPENDS_ON -> Utils
+
+@UX_STATE: TitleOnly -> Header shows page title without optional slots.
+@UX_STATE: WithContext -> Subtitle and action slots expand the header composition.
 -->
 
 <script>
diff --git a/frontend/src/lib/ui/Select.svelte b/frontend/src/lib/ui/Select.svelte
index 73756720..27c69521 100644
--- a/frontend/src/lib/ui/Select.svelte
+++ b/frontend/src/lib/ui/Select.svelte
@@ -1,9 +1,13 @@
 <!-- [DEF:Select:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 2
 @SEMANTICS: select, dropdown, form-field, ui-atom
 @PURPOSE:   Standardized dropdown selection component.
 @LAYER:     Atom
+@RELATION:  DEPENDS_ON -> Utils
+
+@UX_STATE: Idle -> Current value is selectable from the provided options.
+@UX_STATE: Disabled -> Native disabled state prevents selection changes.
 -->
 
 <script>
diff --git a/frontend/src/pages/Dashboard.svelte b/frontend/src/pages/Dashboard.svelte
index c3eb4783..02b98ee4 100755
--- a/frontend/src/pages/Dashboard.svelte
+++ b/frontend/src/pages/Dashboard.svelte
@@ -1,9 +1,14 @@
 <!-- [DEF:Dashboard:Component] -->
 <!--
+@COMPLEXITY: 3
 @SEMANTICS: dashboard, plugins, tools, list
 @PURPOSE: Displays the list of available plugins and allows selecting one.
 @LAYER: UI
+@RELATION: IMPLEMENTS -> [PageContracts]
 @RELATION: DEPENDS_ON -> stores
+@UX_STATE: Loading -> Plugin list is fetched when the page mounts.
+@UX_STATE: Ready -> Available tools are rendered as selectable tiles.
+@UX_STATE: Empty -> No plugin tiles are shown when the list is empty.
 
 @PROPS: None
 @EVENTS: None
diff --git a/frontend/src/pages/Settings.svelte b/frontend/src/pages/Settings.svelte
index 6770f88b..7a257c9f 100755
--- a/frontend/src/pages/Settings.svelte
+++ b/frontend/src/pages/Settings.svelte
@@ -1,13 +1,18 @@
-<!-- [DEF:Settings:Component] -->
-<!--
-@SEMANTICS: settings, ui, configuration
-@PURPOSE:   The main settings page for the application, allowing management of environments and global settings.
-@LAYER:     UI
-@RELATION:  CALLS -> api.js
-@RELATION:  USES -> stores.js
-
-@PROPS: None
-@EVENTS: None
+<!-- [DEF:Settings:Component] -->
+<!--
+@COMPLEXITY: 3
+@SEMANTICS: settings, ui, configuration
+@PURPOSE:   The main settings page for the application, allowing management of environments and global settings.
+@LAYER:     UI
+@RELATION:  IMPLEMENTS -> [PageContracts]
+@RELATION:  CALLS -> api.js
+@RELATION:  USES -> stores.js
+@UX_STATE:  Loading -> Settings and environments are fetched before forms become interactive.
+@UX_STATE:  Ready -> Environment and global setting controls are editable.
+@UX_STATE:  Error -> Toast and inline feedback preserve the current settings context for retry.
+
+@PROPS: None
+@EVENTS: None
 @INVARIANT: Settings changes must be saved to the backend.
 -->
 <script>
diff --git a/frontend/src/routes/+error.svelte b/frontend/src/routes/+error.svelte
index 340e31c8..2f818795 100644
--- a/frontend/src/routes/+error.svelte
+++ b/frontend/src/routes/+error.svelte
@@ -1,12 +1,16 @@
 <!-- [DEF:ErrorPage:Page] -->
 <!--
 @RELATION: USES -> App
+@RELATION: IMPLEMENTS -> [RoutePages]
+@RELATION: IMPLEMENTS -> [PageContracts]
+@RELATION: BINDS_TO -> [NavigationContracts]
 -->
 <script>
     /**
      * @COMPLEXITY: 3
      * @PURPOSE: Global error page displaying HTTP status and messages
      * @LAYER: UI
+     * @RELATION: BINDS_TO -> NavigationContracts
      * @UX_STATE: Error -> Displays error code and message with home link
      */
     import { page } from "$app/state";
diff --git a/frontend/src/routes/+layout.svelte b/frontend/src/routes/+layout.svelte
index 6c1420f8..09b56c5c 100644
--- a/frontend/src/routes/+layout.svelte
+++ b/frontend/src/routes/+layout.svelte
@@ -4,6 +4,7 @@
 @SEMANTICS: layout, root, navigation, sidebar, toast
 @PURPOSE:   Root layout component that provides global UI structure (Sidebar, Navbar, Footer, TaskDrawer, Toasts).
 @LAYER:     UI (Layout)
+@RELATION:  IMPLEMENTS -> [NavigationContracts]
 @RELATION:  DEPENDS_ON -> Sidebar
 @RELATION:  DEPENDS_ON -> TopNavbar
 @RELATION:  DEPENDS_ON -> Footer
@@ -100,4 +101,4 @@
     {/if}
 </main>
 <!-- [/DEF:layout:Module] -->
-<!-- [/DEF:frontend.src.routes.+layout:Module] -->
+<!-- [/DEF:RootLayout:Module] -->
diff --git a/frontend/src/routes/+page.svelte b/frontend/src/routes/+page.svelte
index 6cea7de4..143da1a4 100644
--- a/frontend/src/routes/+page.svelte
+++ b/frontend/src/routes/+page.svelte
@@ -1,6 +1,9 @@
 <!-- [DEF:HomePage:Page] -->
 <!--
 @RELATION: USES -> App
+@RELATION: IMPLEMENTS -> [RoutePages]
+@RELATION: IMPLEMENTS -> [PageContracts]
+@RELATION: BINDS_TO -> [NavigationContracts]
 -->
 <script>
   /**
diff --git a/frontend/src/routes/_contracts.md b/frontend/src/routes/_contracts.md
new file mode 100644
index 00000000..c9f5de28
--- /dev/null
+++ b/frontend/src/routes/_contracts.md
@@ -0,0 +1,22 @@
+# [DEF:RoutePages:Standard]
+# @COMPLEXITY: 3
+# @PURPOSE: Shared semantic route-page registry for SvelteKit route surfaces in the frontend route layer.
+# @RELATION: IMPLEMENTS -> [PageContracts]
+# @RELATION: BINDS_TO -> [NavigationContracts]
+# [/DEF:RoutePages:Standard]
+
+# [DEF:PageContracts:Standard]
+# @COMPLEXITY: 4
+# @PURPOSE: Define the minimum page-level semantic metadata required for route and page surfaces without changing UI behavior.
+# @RELATION: DEPENDS_ON -> [RoutePages]
+# @PRE: Route and page files keep matched anchors and preserve existing runtime behavior.
+# @POST: Route and page surfaces expose purpose, relation, and UX-state metadata for semantic auditing.
+# @SIDE_EFFECT: Semantic metadata only; no runtime logic changes.
+# [/DEF:PageContracts:Standard]
+
+# [DEF:NavigationContracts:Standard]
+# @COMPLEXITY: 3
+# @PURPOSE: Track navigation-shell and redirect semantics that connect page routes to the shared application layout.
+# @RELATION: DEPENDS_ON -> [RootLayout]
+# @RELATION: IMPLEMENTS -> [RoutePages]
+# [/DEF:NavigationContracts:Standard]
diff --git a/frontend/src/routes/admin/users/+page.svelte b/frontend/src/routes/admin/users/+page.svelte
index f8e466e5..00caaa3f 100644
--- a/frontend/src/routes/admin/users/+page.svelte
+++ b/frontend/src/routes/admin/users/+page.svelte
@@ -1,10 +1,17 @@
 <!-- [DEF:AdminUsersPage:Component] -->
 <!--
+@COMPLEXITY: 3
 @SEMANTICS: admin, user-management, rbac
 @PURPOSE:   UI for managing system users and their roles.
 @LAYER:     Feature
+@RELATION:  IMPLEMENTS -> [RoutePages]
+@RELATION:  IMPLEMENTS -> [PageContracts]
 @RELATION:  DEPENDS_ON -> frontend.src.services.adminService
 @RELATION:  DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
+@UX_STATE:  Loading -> User table and role assignments wait for admin data.
+@UX_STATE:  Ready -> User list and create-edit controls are interactive.
+@UX_STATE:  Modal -> User create or edit dialog is active while background list stays intact.
+@UX_STATE:  Error -> Inline admin error is shown without discarding current form state.
 
 @INVARIANT: Only accessible by users with "admin:users" permission.
 -->
diff --git a/frontend/src/routes/dashboards/+page.svelte b/frontend/src/routes/dashboards/+page.svelte
index 4e97a238..6f85ed04 100644
--- a/frontend/src/routes/dashboards/+page.svelte
+++ b/frontend/src/routes/dashboards/+page.svelte
@@ -2,10 +2,12 @@
 <script>
   /**
    * @COMPLEXITY: 5
-   * @PURPOSE: Dashboard Hub - Central hub for managing dashboards with Git status and task actions
+   * @PURPOSE: Dashboard hub page for environment-scoped dashboard management with Git status and task actions.
    * @LAYER: UI
-    * @RELATION: BINDS_TO -> sidebarStore
-    * @RELATION: BINDS_TO -> taskDrawerStore
+   * @RELATION: DEPENDS_ON -> [api_module]
+   * @RELATION: BINDS_TO -> [environmentContextStore]
+   * @RELATION: DEPENDS_ON -> [MappingTable]
+   * @RELATION: DEPENDS_ON -> [StartupEnvironmentWizard]
    * @INVARIANT: Always shows dashboards for the active environment from context store
    *
    * @UX_STATE: Loading -> Shows skeleton loader
@@ -15,7 +17,7 @@
    * @UX_STATE: BulkAction-Modal -> Migration or Backup modal open
    * @UX_FEEDBACK: Floating panel slides up from bottom when items selected
    * @UX_RECOVERY: Refresh button reloads dashboard list
-   * @UX_REATIVITY: State: $state, Derived: $derived. Никаких устаревших export let.
+   * @UX_REACTIVITY: State uses $state, derived values use $derived, and effects use $effect.
    *
    * @TEST_CONTRACT Page_DashboardHub ->
    * {
diff --git a/frontend/src/routes/dashboards/[id]/+page.svelte b/frontend/src/routes/dashboards/[id]/+page.svelte
index 6b0c554c..4f02becf 100644
--- a/frontend/src/routes/dashboards/[id]/+page.svelte
+++ b/frontend/src/routes/dashboards/[id]/+page.svelte
@@ -4,8 +4,15 @@
    * @COMPLEXITY: 5
    * @PURPOSE: Dashboard Detail View - Overview of charts and datasets linked to a dashboard
    * @LAYER: UI
+   * @RELATION: IMPLEMENTS -> [RoutePages]
+   * @RELATION: IMPLEMENTS -> [PageContracts]
+   * @RELATION: BINDS_TO -> [NavigationContracts]
     * @RELATION: DEPENDS_ON -> api_module
-   * @INVARIANT: Shows dashboard metadata, charts, and datasets for selected environment
+    * @INVARIANT: Shows dashboard metadata, charts, and datasets for selected environment
+   * @UX_STATE: Loading -> Skeleton and loading feedback remain visible while dashboard detail resolves.
+   * @UX_STATE: Loaded -> Dashboard metadata, linked assets, and Git controls render for the selected dashboard.
+   * @UX_STATE: Validating -> LLM validation actions stay scoped to the current dashboard context.
+   * @UX_STATE: Error -> Inline recovery keeps the user on the current dashboard route.
    * @TEST_DATA: dashboard_detail_ready -> {"dashboard":{"id":11,"title":"Ops","chart_count":3,"dataset_count":2},"taskHistory":[{"id":"t-1","plugin_id":"llm_dashboard_validation","status":"SUCCESS"}],"llmStatus":{"configured":true,"reason":"ok"}}
    * @TEST_DATA: llm_unconfigured -> {"llmStatus":{"configured":false,"reason":"invalid_api_key"}}
    *
diff --git a/frontend/src/routes/dashboards/__tests__/dashboard-profile-override.integration.test.js b/frontend/src/routes/dashboards/__tests__/dashboard-profile-override.integration.test.js
index 46faf390..ea07c91e 100644
--- a/frontend/src/routes/dashboards/__tests__/dashboard-profile-override.integration.test.js
+++ b/frontend/src/routes/dashboards/__tests__/dashboard-profile-override.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, dashboards, profile-filter, override, restore
 // @PURPOSE: Verifies temporary show-all override and restore-on-return behavior for profile-default dashboard filtering.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> frontend/src/routes/dashboards/+page.svelte
+// @RELATION: DEPENDS_ON -> [DashboardHub]
 
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { render, screen, fireEvent, waitFor } from "@testing-library/svelte";
@@ -285,4 +285,4 @@ describe("dashboard-profile-override.integration", () => {
   });
 });
 
-// [/DEF:frontend.src.routes.dashboards.__tests__.dashboard_profile_override_integration:Module]
\ No newline at end of file
+// [/DEF:DashboardProfileOverrideIntegrationTest:Module]
diff --git a/frontend/src/routes/dashboards/health/__tests__/health_page.integration.test.js b/frontend/src/routes/dashboards/health/__tests__/health_page.integration.test.js
index 8e18244e..8b9992a2 100644
--- a/frontend/src/routes/dashboards/health/__tests__/health_page.integration.test.js
+++ b/frontend/src/routes/dashboards/health/__tests__/health_page.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: health-page, integration-test, slug-link, delete-flow
 // @PURPOSE: Lock dashboard health page contract for slug navigation and report deletion.
 // @LAYER: UI Tests
-// @RELATION: VERIFIES -> frontend/src/routes/dashboards/health/+page.svelte
+// @RELATION: DEPENDS_ON -> [HealthCenterPage]
 
 import { describe, it, expect } from 'vitest';
 import fs from 'node:fs';
@@ -40,4 +40,4 @@ describe('Dashboard health page contract', () => {
     expect(source).toContain(': healthStore.refresh();');
   });
 });
-// [/DEF:frontend.src.routes.dashboards.health.__tests__.health_page_integration:Module]
+// [/DEF:HealthPageIntegrationTest:Module]
diff --git a/frontend/src/routes/datasets/review/[id]/__tests__/dataset_review_workspace.ux.test.js b/frontend/src/routes/datasets/review/[id]/__tests__/dataset_review_workspace.ux.test.js
index 5d975221..29443f1d 100644
--- a/frontend/src/routes/datasets/review/[id]/__tests__/dataset_review_workspace.ux.test.js
+++ b/frontend/src/routes/datasets/review/[id]/__tests__/dataset_review_workspace.ux.test.js
@@ -7,7 +7,7 @@
 // @SEMANTICS: dataset-review, workspace, route, ux-tests, review-state, chat-centric, execution-rail
 // @PURPOSE: Verify the `027` dataset review workspace keeps assistant chat as the primary surface while preserving execution rail and resumable intake behavior.
 // @LAYER: UI
-// @RELATION: [VERIFIES] ->[DatasetReviewWorkspace]
+// @RELATION: DEPENDS_ON -> [DatasetReviewWorkspace]
 // @UX_STATE: Empty -> Intake-first workspace renders clear starting actions.
 // @UX_STATE: Importing -> Progressive milestones remain visible while review context is assembled.
 // @UX_STATE: Review -> Workspace exposes left context rail, embedded assistant center, and right execution rail.
diff --git a/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.test.js b/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.test.js
index a5f9c561..ba789a0d 100644
--- a/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.test.js
+++ b/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.test.js
@@ -7,7 +7,7 @@
 // @SEMANTICS: dataset-review, workspace-entry, resume, source-intake, ux-tests
 // @PURPOSE: Verify dataset review entry route exposes resumable sessions alongside the new session intake flow.
 // @LAYER: UI
-// @RELATION: [VERIFIES] ->[DatasetReviewWorkspaceEntry:Page]
+// @RELATION: DEPENDS_ON -> [DatasetReviewWorkspaceEntry]
 // @UX_STATE: Loading -> workspace loader is shown before bootstrap completes.
 // @UX_STATE: ResumeList -> existing sessions render with summary fields and resume links.
 // @UX_STATE: ResumeEmpty -> empty-state copy is shown when no sessions are returned.
diff --git a/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.ux.test.js b/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.ux.test.js
index 40cb8a28..c3865787 100644
--- a/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.ux.test.js
+++ b/frontend/src/routes/datasets/review/__tests__/dataset_review_entry.ux.test.js
@@ -7,7 +7,7 @@
 // @SEMANTICS: dataset-review, workspace-entry, resume, source-intake, ux-tests
 // @PURPOSE: Verify dataset review entry route exposes resumable sessions alongside the new session intake flow.
 // @LAYER: UI
-// @RELATION: [VERIFIES] ->[DatasetReviewWorkspaceEntry:Page]
+// @RELATION: DEPENDS_ON -> [DatasetReviewWorkspaceEntry]
 // @UX_STATE: Loading -> workspace loader is shown before bootstrap completes.
 // @UX_STATE: ResumeList -> existing sessions render with summary fields and resume links.
 // @UX_STATE: ResumeEmpty -> empty-state copy is shown when no sessions are returned.
diff --git a/frontend/src/routes/git/+page.svelte b/frontend/src/routes/git/+page.svelte
index 7dc57cba..b99e4298 100644
--- a/frontend/src/routes/git/+page.svelte
+++ b/frontend/src/routes/git/+page.svelte
@@ -1,8 +1,18 @@
 <!-- [DEF:GitDashboardPage:Component] -->
 <!--
+@COMPLEXITY: 3
 @PURPOSE:   Dashboard management page for Git integration.
 @LAYER:     Page
 @SEMANTICS: git, dashboard, management, ui
+@RELATION:  IMPLEMENTS -> [RoutePages]
+@RELATION:  IMPLEMENTS -> [PageContracts]
+@RELATION:  BINDS_TO -> [NavigationContracts]
+@RELATION:  DEPENDS_ON -> RepositoryDashboardGrid
+@RELATION:  BINDS_TO -> environmentContextStore
+@UX_STATE:  Loading -> Environment and dashboard data are being resolved for the selected repository context.
+@UX_STATE:  Ready -> Git dashboard grid and environment selector are interactive.
+@UX_STATE:  Refreshing -> Changing environment refreshes dashboard data while preserving page context.
+@UX_STATE:  Error -> Toast-driven failure feedback preserves the current filter selection.
 -->
 <script lang="ts">
   import { onMount } from 'svelte';
diff --git a/frontend/src/routes/profile/__tests__/profile-preferences.integration.test.js b/frontend/src/routes/profile/__tests__/profile-preferences.integration.test.js
index 8519e953..b9bc4b09 100644
--- a/frontend/src/routes/profile/__tests__/profile-preferences.integration.test.js
+++ b/frontend/src/routes/profile/__tests__/profile-preferences.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, profile, integration, lookup, persistence, fallback
 // @PURPOSE: Verifies profile binding happy path and degraded lookup manual fallback save flow.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> frontend/src/routes/profile/+page.svelte
+// @RELATION: DEPENDS_ON -> [ProfilePage]
 
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { render, screen, fireEvent, waitFor } from "@testing-library/svelte";
@@ -270,4 +270,4 @@ describe("profile-preferences.integration", () => {
   });
 });
 
-// [/DEF:frontend.src.routes.profile.__tests__.profile_preferences_integration:Module]
+// [/DEF:ProfilePreferencesIntegrationTest:Module]
diff --git a/frontend/src/routes/profile/__tests__/profile-settings-state.integration.test.js b/frontend/src/routes/profile/__tests__/profile-settings-state.integration.test.js
index e27acd39..3f64eecd 100644
--- a/frontend/src/routes/profile/__tests__/profile-settings-state.integration.test.js
+++ b/frontend/src/routes/profile/__tests__/profile-settings-state.integration.test.js
@@ -3,7 +3,7 @@
 // @SEMANTICS: tests, profile, integration, preload, cancel, reload
 // @PURPOSE: Verifies profile settings preload, cancel without persistence, and saved-state reload behavior.
 // @LAYER: UI (Tests)
-// @RELATION: TESTS -> frontend/src/routes/profile/+page.svelte
+// @RELATION: DEPENDS_ON -> [ProfilePage]
 
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { render, screen, fireEvent, waitFor } from "@testing-library/svelte";
@@ -270,4 +270,4 @@ describe("profile-settings-state.integration", () => {
   });
 });
 
-// [/DEF:frontend.src.routes.profile.__tests__.profile_settings_state_integration:Module]
\ No newline at end of file
+// [/DEF:ProfileSettingsStateIntegrationTest:Module]
diff --git a/frontend/src/routes/reports/llm/[taskId]/report_page.contract.test.js b/frontend/src/routes/reports/llm/[taskId]/report_page.contract.test.js
index a84f5216..a53a06c3 100644
--- a/frontend/src/routes/reports/llm/[taskId]/report_page.contract.test.js
+++ b/frontend/src/routes/reports/llm/[taskId]/report_page.contract.test.js
@@ -30,4 +30,4 @@ describe("LLM report screenshot effect contract", () => {
   });
 });
 // [/DEF:llm_report_screenshot_effect_contract:Function]
-// [/DEF:frontend.src.routes.reports.llm.taskid.report_page_contract_test:Module]
+// [/DEF:ReportPageContractTest:Module]
diff --git a/frontend/src/routes/settings/__tests__/settings_page.ux.test.js b/frontend/src/routes/settings/__tests__/settings_page.ux.test.js
index 6fdf6914..6c087975 100644
--- a/frontend/src/routes/settings/__tests__/settings_page.ux.test.js
+++ b/frontend/src/routes/settings/__tests__/settings_page.ux.test.js
@@ -1,6 +1,10 @@
-// [DEF:__tests__/settings_page_ux_test:Module]
-// @RELATION: VERIFIES -> ../+page.svelte
+// [DEF:SettingsPageUxTest:Module]
+// @COMPLEXITY: 3
+// @SEMANTICS: settings, page, ux-tests, save-flow
+// @RELATION: DEPENDS_ON -> [SettingsPage]
 // @PURPOSE: Test UX states and transitions
+// @LAYER: UI (Tests)
+
 
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { render, screen, fireEvent, waitFor } from '@testing-library/svelte';
@@ -210,3 +214,5 @@ describe('SettingsPage UX Contracts', () => {
         });
     });
 });
+
+// [/DEF:SettingsPageUxTest:Module]
diff --git a/frontend/src/routes/settings/connections/+page.svelte b/frontend/src/routes/settings/connections/+page.svelte
index fa327c02..5a4df531 100644
--- a/frontend/src/routes/settings/connections/+page.svelte
+++ b/frontend/src/routes/settings/connections/+page.svelte
@@ -1,8 +1,17 @@
 <!-- [DEF:ConnectionsSettingsPage:Component] -->
 <!--
+@COMPLEXITY: 3
 @SEMANTICS: settings, connections, page
 @PURPOSE: Page for managing database connection configurations.
 @LAYER: UI
+@RELATION: IMPLEMENTS -> [RoutePages]
+@RELATION: IMPLEMENTS -> [PageContracts]
+@RELATION: BINDS_TO -> [NavigationContracts]
+@RELATION: DEPENDS_ON -> ConnectionForm
+@RELATION: DEPENDS_ON -> ConnectionList
+@UX_STATE: Ready -> Connection form and saved connection list render side by side.
+@UX_STATE: Saving -> Successful form submission refreshes the list without leaving the page.
+@UX_STATE: Error -> Child components surface validation or request errors inline.
 -->
 <script>
     import ConnectionForm from '../../../components/tools/ConnectionForm.svelte';
diff --git a/frontend/src/routes/settings/git/+page.svelte b/frontend/src/routes/settings/git/+page.svelte
index 7a6e1e21..4e2374ed 100644
--- a/frontend/src/routes/settings/git/+page.svelte
+++ b/frontend/src/routes/settings/git/+page.svelte
@@ -1,10 +1,18 @@
 <!-- [DEF:GitSettingsPage:Component] -->
 <!--
+@COMPLEXITY: 3
 @SEMANTICS: git, settings, configuration, integration
 @PURPOSE:   Manage Git server configurations for dashboard versioning.
 @LAYER:     Page
+@RELATION:  IMPLEMENTS -> [RoutePages]
+@RELATION:  IMPLEMENTS -> [PageContracts]
+@RELATION:  BINDS_TO -> [NavigationContracts]
 @RELATION:  USES -> gitService
 @RELATION:  USES -> Button, Input, Card, PageHeader, Select
+@UX_STATE:  Loading -> Existing Git server configurations are fetched on entry.
+@UX_STATE:  Editing -> Configuration form supports create and edit flows in place.
+@UX_STATE:  Testing -> Connection validation feedback is shown before save completion.
+@UX_STATE:  Error -> Toast feedback reports failures while preserving entered configuration values.
 
 @INVARIANT: All configurations must be validated via connection test.
 -->
@@ -71,7 +79,7 @@
     async function handleTest() {
         testing = true;
         try {
-            const testPayload = { ...newConfig };
+            const testPayload = { ...newConfig, config_id: null };
             if (isEditing && editingConfigId) {
                 testPayload.config_id = editingConfigId;
             }
diff --git a/frontend/src/routes/settings/git/__tests__/git_settings_page.ux.test.js b/frontend/src/routes/settings/git/__tests__/git_settings_page.ux.test.js
index a429bb01..ffbe1561 100644
--- a/frontend/src/routes/settings/git/__tests__/git_settings_page.ux.test.js
+++ b/frontend/src/routes/settings/git/__tests__/git_settings_page.ux.test.js
@@ -1,6 +1,9 @@
 // [DEF:GitSettingsPageUxTest:Module]
-// @RELATION: VERIFIES -> ../+page.svelte
+// @COMPLEXITY: 3
+// @SEMANTICS: settings, git, page, ux-tests, form, toast
+// @RELATION: DEPENDS_ON -> [GitSettingsPage]
 // @PURPOSE: Test UX states and transitions for the Git Settings page
+// @LAYER: UI (Tests)
 
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { render, screen, fireEvent, waitFor } from '@testing-library/svelte';
@@ -206,4 +209,4 @@ describe('GitSettingsPage UX Contracts', () => {
         });
     });
 });
-// [/DEF:frontend.src.routes.settings.git.__tests__.git_settings_page_ux_test:Module]
+// [/DEF:GitSettingsPageUxTest:Module]
diff --git a/frontend/src/routes/storage/+page.svelte b/frontend/src/routes/storage/+page.svelte
index 9f8542fd..039bd807 100644
--- a/frontend/src/routes/storage/+page.svelte
+++ b/frontend/src/routes/storage/+page.svelte
@@ -1,8 +1,12 @@
 <!-- [DEF:StorageIndexPage:Page] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 3
 @PURPOSE:   Redirect to the backups page as the default storage view.
 @LAYER:     Page
+@RELATION:  IMPLEMENTS -> [RoutePages]
+@RELATION:  IMPLEMENTS -> [PageContracts]
+@RELATION:  BINDS_TO -> [NavigationContracts]
+@UX_STATE:  Redirecting -> Immediately transfers the user to /storage/backups.
 @INVARIANT: Always redirects to /storage/backups.
 -->
 <script>
diff --git a/frontend/src/routes/storage/backups/+page.svelte b/frontend/src/routes/storage/backups/+page.svelte
index 79fec3a3..9aa19d4f 100644
--- a/frontend/src/routes/storage/backups/+page.svelte
+++ b/frontend/src/routes/storage/backups/+page.svelte
@@ -1,10 +1,14 @@
 <!-- [DEF:StorageBackupsPage:Page] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 3
 @SEMANTICS: storage, backups, routing
 @PURPOSE:   Temporary switch to legacy storage browser for backup UX validation.
 @LAYER:     Page
+@RELATION:  IMPLEMENTS -> [RoutePages]
+@RELATION:  IMPLEMENTS -> [PageContracts]
+@RELATION:  BINDS_TO -> [NavigationContracts]
 @RELATION:  REDIRECTS_TO -> /tools/storage
+@UX_STATE:  Redirecting -> Immediately transfers the user to the legacy storage browser.
 
 @INVARIANT: Always redirects to /tools/storage.
 -->
diff --git a/frontend/src/routes/tools/backups/+page.svelte b/frontend/src/routes/tools/backups/+page.svelte
index 8f335a6e..7717e371 100644
--- a/frontend/src/routes/tools/backups/+page.svelte
+++ b/frontend/src/routes/tools/backups/+page.svelte
@@ -1,9 +1,16 @@
 <!-- [DEF:BackupPage:Component] -->
 <!--
+@COMPLEXITY: 3
 @SEMANTICS: backup, page, tools
 @PURPOSE:   Entry point for the Backup Management interface.
 @LAYER:     Page
+@RELATION:  IMPLEMENTS -> [RoutePages]
+@RELATION:  IMPLEMENTS -> [PageContracts]
+@RELATION:  BINDS_TO -> [NavigationContracts]
 @RELATION:  USES -> BackupManager
+@UX_STATE:  Loading -> Shared page shell mounts before backup management content becomes interactive.
+@UX_STATE:  Ready -> Backup management tools render inside the tools workspace.
+@UX_STATE:  Error -> Nested manager feedback remains contained within the backup workspace.
 -->
 
 <script lang="ts">
@@ -24,4 +31,4 @@
 </div>
 <!-- [/SECTION] -->
 
-<!-- [/DEF:BackupPage:Component] -->
\ No newline at end of file
+<!-- [/DEF:BackupPage:Component] -->
diff --git a/frontend/src/routes/tools/debug/+page.svelte b/frontend/src/routes/tools/debug/+page.svelte
index 10773b9d..339be364 100644
--- a/frontend/src/routes/tools/debug/+page.svelte
+++ b/frontend/src/routes/tools/debug/+page.svelte
@@ -1,9 +1,17 @@
 <!-- [DEF:DebugPage:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 3
 @SEMANTICS: debug, page, tool
 @PURPOSE: Page for system diagnostics and debugging.
 @LAYER: UI
+@RELATION: IMPLEMENTS -> [RoutePages]
+@RELATION: IMPLEMENTS -> [PageContracts]
+@RELATION: BINDS_TO -> [NavigationContracts]
+@RELATION: DEPENDS_ON -> DebugTool
+@RELATION: DEPENDS_ON -> TaskRunner
+@UX_STATE: Ready -> Debug controls and task runner render in a two-column tools layout.
+@UX_STATE: Running -> Long-running diagnostics are observed through the adjacent task runner.
+@UX_STATE: Error -> Nested diagnostic failures remain scoped to the debug workspace.
 -->
 <script>
     import DebugTool from '../../../components/tools/DebugTool.svelte';
diff --git a/frontend/src/routes/tools/mapper/+page.svelte b/frontend/src/routes/tools/mapper/+page.svelte
index 7335e262..b3a6dc5e 100644
--- a/frontend/src/routes/tools/mapper/+page.svelte
+++ b/frontend/src/routes/tools/mapper/+page.svelte
@@ -1,9 +1,17 @@
 <!-- [DEF:MapperPage:Component] -->
 <!--
-@COMPLEXITY: 1
+@COMPLEXITY: 3
 @SEMANTICS: mapper, page, tool
 @PURPOSE: Page for the dataset column mapper tool.
 @LAYER: UI
+@RELATION: IMPLEMENTS -> [RoutePages]
+@RELATION: IMPLEMENTS -> [PageContracts]
+@RELATION: BINDS_TO -> [NavigationContracts]
+@RELATION: DEPENDS_ON -> MapperTool
+@RELATION: DEPENDS_ON -> TaskRunner
+@UX_STATE: Ready -> Mapper tool and task runner share the main tools workspace.
+@UX_STATE: Running -> Mapping jobs execute while progress remains visible in the task runner.
+@UX_STATE: Error -> Mapping-specific validation or execution failures remain visible without route changes.
 -->
 <script>
     import MapperTool from '../../../components/tools/MapperTool.svelte';
diff --git a/frontend/src/services/__tests__/gitService.test.js b/frontend/src/services/__tests__/gitService.test.js
index 94155eb5..6d139ef9 100644
--- a/frontend/src/services/__tests__/gitService.test.js
+++ b/frontend/src/services/__tests__/gitService.test.js
@@ -1,6 +1,9 @@
 // [DEF:gitServiceContractTests:Module]
-// @RELATION: VERIFIES -> ../gitService.js
+// @COMPLEXITY: 3
+// @SEMANTICS: git-service, api-client, contract-tests
+// @RELATION: DEPENDS_ON -> [GitServiceClient]
 // @PURPOSE: API client tests ensuring correct endpoints are called per contract
+// @LAYER: Infra (Tests)
 
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { gitService } from '../gitService';
diff --git a/semantics/semantic_map.json b/semantics/semantic_map.json
index cb886610..fe342aac 100644
--- a/semantics/semantic_map.json
+++ b/semantics/semantic_map.json
@@ -1,6 +1,6 @@
 {
   "project_root": ".",
-  "generated_at": "2026-03-21T16:00:17.629355",
+  "generated_at": "2026-03-26T13:58:51.000971",
   "modules": [
     {
       "name": "MergeSpec",
@@ -61456,14 +61456,15 @@
     {
       "name": "Counter",
       "type": "Component",
-      "complexity": 1,
+      "complexity": 2,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 17,
+      "end_line": 20,
       "tags": {
-        "COMPLEXITY": "1",
+        "COMPLEXITY": "2",
         "PURPOSE": "Simple counter demo component",
-        "LAYER": "UI"
+        "LAYER": "UI",
+        "UX_STATE": "Incremented -> Count increases immediately after button activation."
       },
       "relations": [],
       "children": [],
@@ -61476,7 +61477,7 @@
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 8
+          "line": 11
         }
       ]
     },
@@ -61786,7 +61787,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 412,
+      "end_line": 422,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "api, client, fetch, rest",
@@ -61847,7 +61848,7 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 54,
-          "end_line": 80,
+          "end_line": 89,
           "tags": {
             "PURPOSE": "Avoid noisy toasts for expected non-critical API failures.",
             "PRE": "endpoint can be empty; error can be null.",
@@ -61866,8 +61867,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 82,
-          "end_line": 97,
+          "start_line": 91,
+          "end_line": 106,
           "tags": {
             "PURPOSE": "Returns the WebSocket URL for a specific task, with fallback logic.",
             "PRE": "taskId is provided.",
@@ -61888,8 +61889,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 99,
-          "end_line": 113,
+          "start_line": 108,
+          "end_line": 123,
           "tags": {
             "PURPOSE": "Returns headers with Authorization if token exists."
           },
@@ -61906,8 +61907,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 115,
-          "end_line": 139,
+          "start_line": 125,
+          "end_line": 149,
           "tags": {
             "PURPOSE": "Generic GET request wrapper.",
             "PRE": "endpoint string is provided.",
@@ -61928,8 +61929,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 141,
-          "end_line": 169,
+          "start_line": 151,
+          "end_line": 179,
           "tags": {
             "PURPOSE": "Generic GET wrapper for binary payloads.",
             "PRE": "endpoint string is provided.",
@@ -61949,8 +61950,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 171,
-          "end_line": 198,
+          "start_line": 181,
+          "end_line": 208,
           "tags": {
             "PURPOSE": "Generic POST request wrapper.",
             "PRE": "endpoint and body are provided.",
@@ -61971,8 +61972,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 200,
-          "end_line": 225,
+          "start_line": 210,
+          "end_line": 235,
           "tags": {
             "PURPOSE": "Generic DELETE request wrapper.",
             "PRE": "endpoint is provided.",
@@ -61993,8 +61994,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 227,
-          "end_line": 261,
+          "start_line": 237,
+          "end_line": 271,
           "tags": {
             "PURPOSE": "Generic request wrapper.",
             "PRE": "endpoint and method are provided.",
@@ -62013,8 +62014,8 @@
           "type": "Data",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 263,
-          "end_line": 410,
+          "start_line": 273,
+          "end_line": 420,
           "tags": {
             "PURPOSE": "API client object with specific methods."
           },
@@ -62031,7 +62032,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 412 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 422 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -62541,7 +62542,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 71,
+      "end_line": 121,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "assistant, store, ui-state, conversation",
@@ -62562,8 +62563,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 21,
-          "end_line": 32,
+          "start_line": 24,
+          "end_line": 35,
           "tags": {
             "PURPOSE": "Toggle assistant panel visibility.",
             "PRE": "Store is initialized.",
@@ -62582,8 +62583,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 34,
-          "end_line": 45,
+          "start_line": 37,
+          "end_line": 48,
           "tags": {
             "PURPOSE": "Open assistant panel.",
             "PRE": "Store is initialized.",
@@ -62597,13 +62598,33 @@
             "score": 1.0
           }
         },
+        {
+          "name": "openAssistantChatWithContext",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 50,
+          "end_line": 68,
+          "tags": {
+            "PURPOSE": "Open assistant panel with dataset review session context and optional seeded prompt/focus target.",
+            "PRE": "Context payload may be partial.",
+            "POST": "Assistant drawer opens with session binding and visible focus metadata."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "closeAssistantChat",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 47,
-          "end_line": 58,
+          "start_line": 70,
+          "end_line": 81,
           "tags": {
             "PURPOSE": "Close assistant panel.",
             "PRE": "Store is initialized.",
@@ -62622,8 +62643,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 60,
-          "end_line": 70,
+          "start_line": 83,
+          "end_line": 93,
           "tags": {
             "PURPOSE": "Bind current conversation id in UI state.",
             "PRE": "conversationId is string-like identifier.",
@@ -62636,6 +62657,66 @@
             "issues": [],
             "score": 1.0
           }
+        },
+        {
+          "name": "setAssistantDatasetReviewSessionId",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 95,
+          "end_line": 102,
+          "tags": {
+            "PURPOSE": "Bind active dataset review session to assistant state.",
+            "PRE": "session identifier may be null when workspace context is cleared.",
+            "POST": "store.datasetReviewSessionId updated."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "setAssistantSeedMessage",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 104,
+          "end_line": 111,
+          "tags": {
+            "PURPOSE": "Stage a seeded assistant prompt for contextual send UX.",
+            "PRE": "seedMessage can be empty to clear staged draft.",
+            "POST": "store.seedMessage updated."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "setAssistantFocusTarget",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 113,
+          "end_line": 120,
+          "tags": {
+            "PURPOSE": "Track the workspace entity currently referenced by assistant context.",
+            "PRE": "focusTarget may be null to clear prior focus.",
+            "POST": "store.focusTarget updated."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
         }
       ],
       "compliance": {
@@ -62647,16 +62728,12 @@
     {
       "name": "taskDrawer",
       "type": "Store",
-      "complexity": 5,
-      "tier": "CRITICAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 169,
+      "end_line": 165,
       "tags": {
-        "SIDE_EFFECT": "None",
-        "PRE": "Default pre condition",
-        "POST": "Default post condition",
-        "DATA_CONTRACT": "Default state data",
-        "COMPLEXITY": "5",
+        "COMPLEXITY": "3",
         "PURPOSE": "Manage Task Drawer visibility and resource-to-task mapping",
         "LAYER": "UI",
         "INVARIANT": "resourceTaskMap always reflects current task associations",
@@ -62675,15 +62752,15 @@
       ],
       "children": [],
       "compliance": {
-        "valid": false,
+        "valid": true,
         "issues": [
           {
             "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "ERROR",
+            "severity": "WARNING",
             "line_number": 1
           }
         ],
-        "score": 0.45714285714285713
+        "score": 0.7
       }
     },
     {
@@ -62692,7 +62769,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 169,
+      "end_line": 165,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/stores/taskDrawer.js",
         "COMPLEXITY": "1",
@@ -62705,8 +62782,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 33,
-          "end_line": 33,
+          "start_line": 29,
+          "end_line": 29,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62724,8 +62801,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 58,
-          "end_line": 58,
+          "start_line": 54,
+          "end_line": 54,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62743,8 +62820,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 76,
-          "end_line": 76,
+          "start_line": 72,
+          "end_line": 72,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62762,8 +62839,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 90,
-          "end_line": 90,
+          "start_line": 86,
+          "end_line": 86,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62781,8 +62858,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 99,
-          "end_line": 99,
+          "start_line": 95,
+          "end_line": 95,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62800,8 +62877,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 113,
-          "end_line": 113,
+          "start_line": 109,
+          "end_line": 109,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62819,8 +62896,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 126,
-          "end_line": 126,
+          "start_line": 122,
+          "end_line": 122,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62838,8 +62915,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 141,
-          "end_line": 141,
+          "start_line": 137,
+          "end_line": 137,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -62857,8 +62934,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 161,
-          "end_line": 161,
+          "start_line": 157,
+          "end_line": 157,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -63763,7 +63840,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": null,
+      "end_line": 87,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "test, store, assistant, toggle, conversation",
@@ -63783,8 +63860,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 19,
-          "end_line": 59,
+          "start_line": 22,
+          "end_line": 86,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Group store unit scenarios for assistant panel behavior.",
@@ -63804,12 +63881,12 @@
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 19
+                "line_number": 22
               },
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 19
+                "line_number": 22
               }
             ],
             "score": 0.5499999999999999
@@ -63817,15 +63894,9 @@
         }
       ],
       "compliance": {
-        "valid": false,
-        "issues": [
-          {
-            "message": "Unclosed Anchor: [DEF:AssistantChatTest:Module] started at line 1",
-            "severity": "ERROR",
-            "line_number": 1
-          }
-        ],
-        "score": 0.0
+        "valid": true,
+        "issues": [],
+        "score": 0.925
       }
     },
     {
@@ -64106,11 +64177,11 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 88,
+      "end_line": 102,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "assistant, api, client, chat, confirmation",
-        "PURPOSE": "API client wrapper for assistant chat, confirmation actions, and history retrieval.",
+        "PURPOSE": "API client wrapper for assistant chat, session-scoped prompts, confirmation actions, and history retrieval.",
         "LAYER": "Infra-API",
         "INVARIANT": "All assistant requests must use requestApi wrapper (no native fetch)."
       },
@@ -64142,12 +64213,32 @@
           }
         },
         {
-          "name": "confirmAssistantOperation",
+          "name": "buildAssistantSeedMessage",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 20,
-          "end_line": 27,
+          "end_line": 32,
+          "tags": {
+            "PURPOSE": "Compose visible assistant seed text from context label and prompt body.",
+            "PRE": "prompt contains the user-visible request.",
+            "POST": "Returns trimmed seed message string for prefilled input."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "confirmAssistantOperation",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 34,
+          "end_line": 41,
           "tags": {
             "PURPOSE": "Confirm a pending risky assistant operation.",
             "PRE": "confirmationId references an existing pending token.",
@@ -64166,8 +64257,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 29,
-          "end_line": 36,
+          "start_line": 43,
+          "end_line": 50,
           "tags": {
             "PURPOSE": "Cancel a pending risky assistant operation.",
             "PRE": "confirmationId references an existing pending token.",
@@ -64186,8 +64277,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 38,
-          "end_line": 52,
+          "start_line": 52,
+          "end_line": 66,
           "tags": {
             "PURPOSE": "Retrieve paginated assistant conversation history.",
             "PRE": "page/pageSize are positive integers.",
@@ -64206,8 +64297,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 54,
-          "end_line": 77,
+          "start_line": 68,
+          "end_line": 91,
           "tags": {
             "PURPOSE": "Retrieve paginated conversation list for assistant sidebar/history switcher.",
             "PRE": "page/pageSize are positive integers.",
@@ -64226,8 +64317,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 79,
-          "end_line": 86,
+          "start_line": 93,
+          "end_line": 100,
           "tags": {
             "PURPOSE": "Soft-delete or hard-delete a conversation.",
             "PRE": "conversationId string is provided.",
@@ -64248,6 +64339,153 @@
         "score": 0.925
       }
     },
+    {
+      "name": "DatasetReviewApi",
+      "type": "Module",
+      "complexity": 3,
+      "tier": "STANDARD",
+      "start_line": 1,
+      "end_line": 132,
+      "tags": {
+        "COMPLEXITY": "3",
+        "SEMANTICS": "dataset-review, api, session-version, headers, conflict-handling",
+        "PURPOSE": "Provide shared frontend helpers for dataset review session-scoped API requests, optimistic-lock propagation, and refreshed session DTO normalization.",
+        "LAYER": "Infra-API"
+      },
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "api_module"
+        }
+      ],
+      "children": [
+        {
+          "name": "buildDatasetReviewRequestOptions",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 10,
+          "end_line": 24,
+          "tags": {
+            "PURPOSE": "Attach optimistic-lock session version header when the current version is known.",
+            "PRE": "sessionVersion may be null when no loaded session version exists yet.",
+            "POST": "Returns requestApi-compatible options object."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "requestDatasetReviewApi",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 26,
+          "end_line": 37,
+          "tags": {
+            "PURPOSE": "Proxy dataset review mutations through requestApi with optional optimistic-lock headers.",
+            "PRE": "endpoint and method are valid requestApi inputs.",
+            "POST": "Executes requestApi with X-Session-Version only when a session version is known."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "isDatasetReviewConflictError",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 39,
+          "end_line": 46,
+          "tags": {
+            "PURPOSE": "Detect optimistic-lock conflicts from dataset review mutations.",
+            "PRE": "error may be null or a normalized API error.",
+            "POST": "Returns true when the mutation failed with 409 conflict semantics."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "getDatasetReviewConflictMessage",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 48,
+          "end_line": 58,
+          "tags": {
+            "PURPOSE": "Return explicit 409-style guidance for stale dataset review mutations.",
+            "PRE": "error may be null or a normalized API error.",
+            "POST": "Returns a user-facing conflict message string."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "extractDatasetReviewVersion",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 60,
+          "end_line": 91,
+          "tags": {
+            "PURPOSE": "Resolve the latest session version from refreshed DTO fragments.",
+            "PRE": "payload may be a session summary, a detail payload, or a mutation fragment.",
+            "POST": "Returns the newest known session version or null."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "normalizeDatasetReviewDetail",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 93,
+          "end_line": 130,
+          "tags": {
+            "PURPOSE": "Normalize refreshed session-detail DTOs into the legacy route-friendly workspace shape.",
+            "PRE": "detail may already be legacy-flat or refreshed with nested session/session_version fields.",
+            "POST": "Returns a shape with flattened summary fields plus refreshed collections and version metadata."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        }
+      ],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 0.925
+      }
+    },
     {
       "name": "ReportsApiTest",
       "type": "Module",
@@ -64350,17 +64588,23 @@
     {
       "name": "Select",
       "type": "Component",
-      "complexity": 1,
+      "complexity": 2,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 53,
+      "end_line": 57,
       "tags": {
-        "COMPLEXITY": "1",
+        "COMPLEXITY": "2",
         "SEMANTICS": "select, dropdown, form-field, ui-atom",
         "PURPOSE": "Standardized dropdown selection component.",
-        "LAYER": "Atom"
+        "LAYER": "Atom",
+        "UX_STATE": "Disabled -> Native disabled state prevents selection changes."
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "Utils"
+        }
+      ],
       "children": [],
       "compliance": {
         "valid": true,
@@ -64371,17 +64615,52 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 11
+          "line": 15
         },
         {
           "store": "bindable",
           "type": "WRITES_TO",
-          "line": 17
+          "line": 21
         },
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 22
+          "line": 26
+        }
+      ]
+    },
+    {
+      "name": "Icon",
+      "type": "Component",
+      "complexity": 2,
+      "tier": "TRIVIAL",
+      "start_line": 1,
+      "end_line": 101,
+      "tags": {
+        "COMPLEXITY": "2",
+        "SEMANTICS": "icon, ui-atom, svg",
+        "PURPOSE": "Render the shared inline SVG icon set with consistent sizing and stroke props.",
+        "LAYER": "Atom",
+        "UX_STATE": "Fallback -> Unknown icon names resolve to the dashboard glyph.",
+        "INVARIANT": "Icon output remains aria-hidden because labels belong to the interactive parent."
+      },
+      "relations": [],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      },
+      "data_flow": [
+        {
+          "store": "props",
+          "type": "WRITES_TO",
+          "line": 19
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 81
         }
       ]
     },
@@ -64410,159 +64689,21 @@
     {
       "name": "PageHeader",
       "type": "Component",
-      "complexity": 1,
+      "complexity": 2,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 40,
+      "end_line": 44,
       "tags": {
-        "COMPLEXITY": "1",
+        "COMPLEXITY": "2",
         "SEMANTICS": "page-header, layout-atom",
         "PURPOSE": "Standardized page header with title and action area.",
-        "LAYER": "Atom"
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      },
-      "data_flow": [
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 11
-        },
-        {
-          "store": "props",
-          "type": "WRITES_TO",
-          "line": 21
-        }
-      ]
-    },
-    {
-      "name": "Card",
-      "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 1,
-      "end_line": 51,
-      "tags": {
-        "COMPLEXITY": "1",
-        "SEMANTICS": "card, container, ui-atom",
-        "PURPOSE": "Standardized container with padding and elevation.",
-        "LAYER": "Atom"
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      },
-      "data_flow": [
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 11
-        },
-        {
-          "store": "props",
-          "type": "WRITES_TO",
-          "line": 21
-        }
-      ]
-    },
-    {
-      "name": "Button",
-      "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 1,
-      "end_line": 68,
-      "tags": {
-        "COMPLEXITY": "1",
-        "SEMANTICS": "button, ui-atom, interactive",
-        "PURPOSE": "Define component interface and default values (Svelte 5 Runes).",
         "LAYER": "Atom",
-        "INVARIANT": "Supports accessible labels and keyboard navigation."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      },
-      "data_flow": [
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 14
-        },
-        {
-          "store": "props",
-          "type": "WRITES_TO",
-          "line": 31
-        }
-      ]
-    },
-    {
-      "name": "Input",
-      "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 1,
-      "end_line": 60,
-      "tags": {
-        "COMPLEXITY": "1",
-        "SEMANTICS": "input, form-field, ui-atom",
-        "PURPOSE": "Standardized text input component with label and error handling.",
-        "LAYER": "Atom",
-        "INVARIANT": "Consistent spacing and focus states."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      },
-      "data_flow": [
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 13
-        },
-        {
-          "store": "bindable",
-          "type": "WRITES_TO",
-          "line": 19
-        },
-        {
-          "store": "props",
-          "type": "WRITES_TO",
-          "line": 26
-        }
-      ]
-    },
-    {
-      "name": "LanguageSwitcher",
-      "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 1,
-      "end_line": 28,
-      "tags": {
-        "COMPLEXITY": "1",
-        "SEMANTICS": "language-switcher, i18n-ui, ui-atom",
-        "PURPOSE": "Dropdown component to switch between supported languages.",
-        "LAYER": "Atom"
+        "UX_STATE": "WithContext -> Subtitle and action slots expand the header composition."
       },
       "relations": [
         {
-          "type": "BINDS_TO",
-          "target": "i18n.locale"
+          "type": "DEPENDS_ON",
+          "target": "Utils"
         }
       ],
       "children": [],
@@ -64575,12 +64716,180 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 12
+          "line": 15
+        },
+        {
+          "store": "props",
+          "type": "WRITES_TO",
+          "line": 25
+        }
+      ]
+    },
+    {
+      "name": "Card",
+      "type": "Component",
+      "complexity": 2,
+      "tier": "TRIVIAL",
+      "start_line": 1,
+      "end_line": 55,
+      "tags": {
+        "COMPLEXITY": "2",
+        "SEMANTICS": "card, container, ui-atom",
+        "PURPOSE": "Standardized container with padding and elevation.",
+        "LAYER": "Atom",
+        "UX_STATE": "Titled -> Header row appears above the padded content area."
+      },
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "Utils"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      },
+      "data_flow": [
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 15
+        },
+        {
+          "store": "props",
+          "type": "WRITES_TO",
+          "line": 25
+        }
+      ]
+    },
+    {
+      "name": "Button",
+      "type": "Component",
+      "complexity": 2,
+      "tier": "TRIVIAL",
+      "start_line": 1,
+      "end_line": 72,
+      "tags": {
+        "COMPLEXITY": "2",
+        "SEMANTICS": "button, ui-atom, interactive",
+        "PURPOSE": "Define component interface and default values (Svelte 5 Runes).",
+        "LAYER": "Atom",
+        "UX_STATE": "Loading -> Spinner replaces the leading area and interaction is disabled.",
+        "INVARIANT": "Supports accessible labels and keyboard navigation.",
+        "TYPE": "{'button' | 'submit' | 'reset'} */ ('button'),"
+      },
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "Utils"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      },
+      "data_flow": [
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 18
+        },
+        {
+          "store": "props",
+          "type": "WRITES_TO",
+          "line": 35
+        }
+      ]
+    },
+    {
+      "name": "Input",
+      "type": "Component",
+      "complexity": 2,
+      "tier": "TRIVIAL",
+      "start_line": 1,
+      "end_line": 65,
+      "tags": {
+        "COMPLEXITY": "2",
+        "SEMANTICS": "input, form-field, ui-atom",
+        "PURPOSE": "Standardized text input component with label and error handling.",
+        "LAYER": "Atom",
+        "UX_STATE": "Disabled -> Native disabled state prevents editing while preserving value visibility.",
+        "INVARIANT": "Consistent spacing and focus states."
+      },
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "Utils"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      },
+      "data_flow": [
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 18
+        },
+        {
+          "store": "bindable",
+          "type": "WRITES_TO",
+          "line": 24
+        },
+        {
+          "store": "props",
+          "type": "WRITES_TO",
+          "line": 31
+        }
+      ]
+    },
+    {
+      "name": "LanguageSwitcher",
+      "type": "Component",
+      "complexity": 2,
+      "tier": "TRIVIAL",
+      "start_line": 1,
+      "end_line": 32,
+      "tags": {
+        "COMPLEXITY": "2",
+        "SEMANTICS": "language-switcher, i18n-ui, ui-atom",
+        "PURPOSE": "Dropdown component to switch between supported languages.",
+        "LAYER": "Atom",
+        "UX_STATE": "Switching -> Bound locale updates immediately after selection."
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "i18n.locale"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "Select"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      },
+      "data_flow": [
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 16
         },
         {
           "store": "locale",
           "type": "WRITES_TO",
-          "line": 24
+          "line": 28
         }
       ]
     },
@@ -64676,645 +64985,395 @@
       }
     },
     {
-      "name": "AssistantChatPanel",
+      "name": "AssistantClarificationCard",
       "type": "Component",
-      "complexity": 3,
-      "tier": "STANDARD",
+      "complexity": 1,
+      "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 862,
+      "end_line": 408,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
-        "COMPLEXITY": "5",
-        "PURPOSE": "Slide-out assistant chat panel for natural language command execution and task tracking.",
-        "LAYER": "UI",
-        "SEMANTICS": "assistant-chat, confirmation, long-running-task, progress-tracking",
-        "INVARIANT": "Risky operations are executed only through explicit confirm action.",
-        "UX_STATE": "Error -> Failed action rendered as assistant failed message.",
-        "UX_FEEDBACK": "Started operation surfaces task_id and quick action to open task drawer.",
-        "UX_RECOVERY": "User can retry command or action from input and action buttons.",
-        "UX_TEST": "NeedsConfirmation -> {click: confirm action, expected: started response with task_id}",
-        "TEST_DATA": "assistant_llm_not_configured -> {\"llmStatus\":{\"configured\":false,\"reason\":\"invalid_api_key\"}}",
-        "TEST_CONTRACT": "Component_AssistantChatPanel ->",
-        "TEST_FIXTURE": "chat_open -> {\"isOpen\": true, \"messages\": [{\"role\": \"assistant\", \"text\": \"Hello\"}]}",
-        "TEST_EDGE": "llm_not_ready -> Renders LLM config warning banner",
-        "TEST_INVARIANT": "action_handling -> verifies: [chat_open]"
+        "COMPLEXITY": "4 -->",
+        "SEMANTICS": "assistant, clarification, dataset-review, mixed-initiative, resumable -->",
+        "PURPOSE": "Render the active dataset-review clarification queue inside AssistantChatPanel so users can answer, skip, defer, and resume questions without leaving the assistant workspace. -->",
+        "LAYER": "UI -->",
+        "PRE": "sessionId belongs to the current dataset review workspace and the assistant drawer is open for session-scoped work. -->",
+        "POST": "Clarification queue state is readable in-chat and answer mutations refresh the active question state without requiring a dedicated dialog. -->",
+        "SIDE_EFFECT": "Reads and mutates clarification state through dataset orchestration APIs. -->",
+        "DATA_CONTRACT": "Input[{sessionId, disabled}] -> Output[{clarification_state|clarification_session|current_question|session}] via onupdated callback. -->",
+        "UX_STATE": "Completed -> No active question remains and resume plus feedback actions stay available. -->",
+        "UX_FEEDBACK": "Save, skip, resume, and feedback results surface inline without hiding the queue context. -->",
+        "UX_RECOVERY": "Users can resume the queue, provide a custom answer, or mark the item for expert review from the same assistant surface. -->",
+        "UX_REACTIVITY": "Uses $props, $state, $derived, and $effect only; no legacy reactive syntax. -->"
       },
       "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "assistantChat"
-        },
         {
           "type": "CALLS",
-          "target": "AssistantApi"
+          "target": "api_module"
         },
         {
-          "type": "DISPATCHES",
-          "target": "taskDrawer"
-        }
-      ],
-      "children": [
-        {
-          "name": "loadHistory",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 101,
-          "end_line": 147,
-          "tags": {
-            "PURPOSE": "Load current conversation history when panel becomes visible.",
-            "PRE": "Panel is open and history request is not already running.",
-            "POST": "messages are populated from persisted history and conversation id is synchronized.",
-            "SIDE_EFFECT": "Performs API call to assistant history endpoint."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "loadConversations",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 149,
-          "end_line": 188,
-          "tags": {
-            "PURPOSE": "Load paginated conversation summaries for quick switching UI.",
-            "PRE": "Panel is open and request not already running.",
-            "POST": "conversations list refreshed or appended based on page."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "removeConversation",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 190,
-          "end_line": 215,
-          "tags": {
-            "PURPOSE": "Removes a conversation from the list and deletes it from the backend.",
-            "PRE": "conversationId string is provided.",
-            "POST": "It is soft-deleted from the API and removed from local UI. If active, reset state."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "loadOlderMessages",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 217,
-          "end_line": 259,
-          "tags": {
-            "PURPOSE": "Lazy-load older messages for active conversation when user scrolls to top.",
-            "PRE": "History has next page and active conversation is known.",
-            "POST": "Older messages are prepended while preserving order."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "appendLocalUserMessage",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 280,
-          "end_line": 299,
-          "tags": {
-            "PURPOSE": "Add optimistic local user message before backend response.",
-            "PRE": "text is non-empty command text.",
-            "POST": "user message appears at the end of messages list."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "appendAssistantResponse",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 301,
-          "end_line": 328,
-          "tags": {
-            "PURPOSE": "Normalize and append assistant response payload to chat list.",
-            "PRE": "response follows assistant message response contract.",
-            "POST": "assistant message appended with state/task/actions metadata."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleSend",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 353,
-          "end_line": 397,
-          "tags": {
-            "PURPOSE": "Submit user command to assistant orchestration API.",
-            "PRE": "input contains a non-empty command and current request is not loading.",
-            "POST": "assistant response is rendered and conversation id is persisted in store.",
-            "SIDE_EFFECT": "Triggers backend command execution pipeline."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "selectConversation",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 399,
-          "end_line": 418,
-          "tags": {
-            "PURPOSE": "Switch active chat context to selected conversation item.",
-            "PRE": "conversation carries valid conversation_id.",
-            "POST": "conversationId updated and history reloaded."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "startNewConversation",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 420,
-          "end_line": 440,
-          "tags": {
-            "PURPOSE": "Create local empty chat context that will be persisted on first message.",
-            "PRE": "Panel is open.",
-            "POST": "Messages reset and new conversation id bound."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleAction",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 442,
-          "end_line": 521,
-          "tags": {
-            "PURPOSE": "Execute assistant action button behavior (open task/reports, confirm, cancel).",
-            "PRE": "action object is produced by assistant response contract.",
-            "POST": "UI navigation or follow-up assistant response is appended.",
-            "SIDE_EFFECT": "May navigate routes or call confirm/cancel API endpoints."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleKeydown",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 523,
-          "end_line": 536,
-          "tags": {
-            "PURPOSE": "Submit command by Enter while preserving multiline input with Shift+Enter.",
-            "PRE": "Keyboard event received from chat input.",
-            "POST": "handleSend is invoked when Enter is pressed without shift modifier."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "stateClass",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 538,
-          "end_line": 557,
-          "tags": {
-            "PURPOSE": "Map assistant state to visual badge style class.",
-            "PRE": "state is a nullable assistant state string.",
-            "POST": "Tailwind class string returned for badge rendering."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleHistoryScroll",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 559,
-          "end_line": 573,
-          "tags": {
-            "PURPOSE": "Trigger lazy history fetch when user scroll reaches top boundary.",
-            "PRE": "Scroll event emitted by history viewport container.",
-            "POST": "loadOlderMessages called when boundary and more pages available."
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
+          "type": "BINDS_TO",
+          "target": "AssistantChatPanel"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "DatasetReviewWorkspace"
         }
       ],
+      "children": [],
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 0.9
+        "score": 1.0
       },
       "data_flow": [
         {
-          "store": "app",
+          "store": "props",
           "type": "READS_FROM",
-          "line": 50
+          "line": 18
+        },
+        {
+          "store": "state",
+          "type": "READS_FROM",
+          "line": 18
+        },
+        {
+          "store": "derived",
+          "type": "READS_FROM",
+          "line": 18
+        },
+        {
+          "store": "effect",
+          "type": "READS_FROM",
+          "line": 18
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 52
+          "line": 20
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 53
+          "line": 21
         },
         {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 54
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 59
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 67
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 68
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 70
+          "store": "props",
+          "type": "WRITES_TO",
+          "line": 29
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 75
+          "line": 31
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 76
+          "line": 32
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 77
+          "line": 33
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 78
+          "line": 34
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 79
+          "line": 35
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 80
+          "line": 36
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 81
+          "line": 37
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 82
+          "line": 38
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 83
+          "line": 39
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 84
+          "line": 40
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 85
+          "line": 41
         },
         {
           "store": "state",
           "type": "WRITES_TO",
+          "line": 42
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 43
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 45
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 46
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 47
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 48
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 51
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 56
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
           "line": 86
         },
         {
-          "store": "state",
+          "store": "t",
           "type": "WRITES_TO",
-          "line": 87
+          "line": 86
         },
         {
-          "store": "state",
+          "store": "t",
           "type": "WRITES_TO",
-          "line": 88
+          "line": 126
         },
         {
-          "store": "state",
+          "store": "t",
           "type": "WRITES_TO",
-          "line": 89
+          "line": 131
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 90
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 157
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 91
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 159
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 92
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 160
         },
         {
-          "store": "state",
+          "store": "t",
           "type": "WRITES_TO",
-          "line": 93
+          "line": 164
         },
         {
-          "store": "derived",
+          "store": "t",
           "type": "WRITES_TO",
-          "line": 96
+          "line": 164
         },
         {
-          "store": "derived",
+          "store": "t",
           "type": "WRITES_TO",
-          "line": 97
+          "line": 185
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 189
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 189
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 213
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 214
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 217
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 217
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 261
+          "line": 223
         },
         {
           "store": "effect",
           "type": "READS_FROM",
+          "line": 239
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 264
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
           "line": 269
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 332
+          "line": 278
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 333
+          "line": 286
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 388
+          "line": 292
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 514
+          "line": 300
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 607
+          "line": 303
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 308
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 334
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 346
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 357
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 360
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 363
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 366
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 613
+          "line": 372
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 625
+          "line": 375
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 629
+          "line": 384
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 632
+          "line": 387
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 635
+          "line": 391
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 646
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 652
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 663
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 672
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 714
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 729
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 736
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 742
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 744
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 745
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 746
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 763
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 764
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 772
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 785
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 791
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 824
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 828
+          "line": 394
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 843
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 854
+          "line": 402
         }
       ]
     },
     {
-      "name": "AssistantChatPanel",
+      "name": "AssistantClarificationCard",
       "type": "Module",
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 900,
+      "end_line": 408,
       "tags": {
-        "PURPOSE": "Auto-generated module for frontend/src/lib/components/assistant/AssistantChatPanel.svelte",
+        "PURPOSE": "Auto-generated module for frontend/src/lib/components/assistant/AssistantClarificationCard.svelte",
         "COMPLEXITY": "1",
         "LAYER": "Unknown"
       },
       "relations": [],
       "children": [
         {
-          "name": "buildConversationTitle",
+          "name": "loadClarificationState",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 330,
-          "end_line": 330,
+          "start_line": 64,
+          "end_line": 64,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65328,12 +65387,12 @@
           }
         },
         {
-          "name": "setConversationFilter",
+          "name": "normalizeAnswerValue",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 336,
-          "end_line": 336,
+          "start_line": 94,
+          "end_line": 94,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65347,12 +65406,12 @@
           }
         },
         {
-          "name": "formatConversationTime",
+          "name": "updateClarificationState",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 346,
-          "end_line": 346,
+          "start_line": 104,
+          "end_line": 104,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65366,12 +65425,50 @@
           }
         },
         {
-          "name": "loadLlmStatus",
+          "name": "submitAnswer",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 579,
-          "end_line": 579,
+          "start_line": 118,
+          "end_line": 118,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "resumeClarification",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 170,
+          "end_line": 170,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "recordClarificationFeedback",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 195,
+          "end_line": 195,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65389,7 +65486,1065 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 900 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 408 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 1
+          }
+        ],
+        "score": 0.85
+      }
+    },
+    {
+      "name": "AssistantChatPanel",
+      "type": "Component",
+      "complexity": 3,
+      "tier": "STANDARD",
+      "start_line": 1,
+      "end_line": 956,
+      "tags": {
+        "COMPLEXITY": "5",
+        "PURPOSE": "Assistant chat workspace for mixed-initiative dataset review clarification, contextual actions, and task tracking.",
+        "LAYER": "UI",
+        "SEMANTICS": "assistant-chat, confirmation, long-running-task, progress-tracking",
+        "INVARIANT": "Risky operations are executed only through explicit confirm action.",
+        "UX_STATE": "Error -> Failed action rendered as assistant failed message.",
+        "UX_FEEDBACK": "Started operation surfaces task_id and quick action to open task drawer.",
+        "UX_RECOVERY": "User can retry command or action from input and action buttons."
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "assistantChat"
+        },
+        {
+          "type": "CALLS",
+          "target": "AssistantApi"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "DatasetReviewWorkspace"
+        },
+        {
+          "type": "DISPATCHES",
+          "target": "taskDrawer"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 0.9
+      },
+      "data_flow": [
+        {
+          "store": "app",
+          "type": "READS_FROM",
+          "line": 25
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 27
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 28
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 29
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 30
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 31
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 32
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 39
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 47
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 48
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 50
+        },
+        {
+          "store": "props",
+          "type": "WRITES_TO",
+          "line": 52
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 57
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 58
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 59
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 60
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 61
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 62
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 63
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 64
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 65
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 66
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 67
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 68
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 69
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 70
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 71
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 72
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 73
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 74
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 75
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 76
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 77
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 80
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 81
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 82
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 85
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 86
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 87
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 88
+        },
+        {
+          "store": "effect",
+          "type": "READS_FROM",
+          "line": 220
+        },
+        {
+          "store": "effect",
+          "type": "READS_FROM",
+          "line": 228
+        },
+        {
+          "store": "effect",
+          "type": "READS_FROM",
+          "line": 237
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 282
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 283
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 332
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 435
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 497
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 500
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 505
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 506
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 509
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 548
+        },
+        {
+          "store": "effect",
+          "type": "READS_FROM",
+          "line": 600
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 624
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 630
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 636
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 645
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 651
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 653
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 668
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 677
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 689
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 694
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 704
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 711
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 729
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 735
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 745
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 753
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 786
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 799
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 805
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 810
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 813
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 814
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 815
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 832
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 832
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 836
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 849
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 856
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 860
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 861
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 865
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 882
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 888
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 918
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 922
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 937
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 948
+        }
+      ]
+    },
+    {
+      "name": "AssistantChatPanel",
+      "type": "Module",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 1,
+      "end_line": 994,
+      "tags": {
+        "PURPOSE": "Auto-generated module for frontend/src/lib/components/assistant/AssistantChatPanel.svelte",
+        "COMPLEXITY": "1",
+        "LAYER": "Unknown"
+      },
+      "relations": [],
+      "children": [
+        {
+          "name": "loadHistory",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 90,
+          "end_line": 90,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "loadConversations",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 129,
+          "end_line": 129,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "removeConversation",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 160,
+          "end_line": 160,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "loadOlderMessages",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 182,
+          "end_line": 182,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "appendLocalUserMessage",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 248,
+          "end_line": 248,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "appendAssistantResponse",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 262,
+          "end_line": 262,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "buildConversationTitle",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 280,
+          "end_line": 280,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "setConversationFilter",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 286,
+          "end_line": 286,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "formatConversationTime",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 296,
+          "end_line": 296,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleSend",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 303,
+          "end_line": 303,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "selectConversation",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 345,
+          "end_line": 345,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "startNewConversation",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 357,
+          "end_line": 357,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleAction",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 371,
+          "end_line": 371,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleKeydown",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 443,
+          "end_line": 443,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "stateClass",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 451,
+          "end_line": 451,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleHistoryScroll",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 461,
+          "end_line": 461,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "loadLlmStatus",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 474,
+          "end_line": 474,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "clearFocusTarget",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 487,
+          "end_line": 487,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "buildContextSummary",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 491,
+          "end_line": 491,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "isConfirmationCard",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 513,
+          "end_line": 513,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "getMessageFocusTarget",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 517,
+          "end_line": 517,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "syncMessageFocus",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 537,
+          "end_line": 537,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "renderConfirmationScope",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 545,
+          "end_line": 545,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "hasConfirmationScope",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 559,
+          "end_line": 559,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "dismissClarificationBanner",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 563,
+          "end_line": 563,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "resumeClarificationFromBanner",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 567,
+          "end_line": 567,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "refreshDatasetReviewSession",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 575,
+          "end_line": 575,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleClarificationUpdated",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 588,
+          "end_line": 588,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        }
+      ],
+      "compliance": {
+        "valid": true,
+        "issues": [
+          {
+            "message": "Fractal limit warning: Module length is 994 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -65403,7 +66558,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": null,
+      "end_line": 241,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "assistant, integration-test, optimistic-message, conversation-race",
@@ -65423,8 +66578,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 123,
-          "end_line": 178,
+          "start_line": 149,
+          "end_line": 240,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Guard optimistic first-message UX against history reload race in new conversation flow.",
@@ -65444,12 +66599,12 @@
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 123
+                "line_number": 149
               },
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 123
+                "line_number": 149
               }
             ],
             "score": 0.5499999999999999
@@ -65457,20 +66612,15 @@
         }
       ],
       "compliance": {
-        "valid": false,
+        "valid": true,
         "issues": [
-          {
-            "message": "Unclosed Anchor: [DEF:AssistantFirstMessageIntegrationTest:Module] started at line 1",
-            "severity": "ERROR",
-            "line_number": 1
-          },
           {
             "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
             "severity": "WARNING",
             "line_number": 1
           }
         ],
-        "score": 0.0
+        "score": 0.775
       }
     },
     {
@@ -65479,7 +66629,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": null,
+      "end_line": 103,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "assistant, integration-test, ux-contract, i18n",
@@ -65545,20 +66695,47 @@
         }
       ],
       "compliance": {
-        "valid": false,
+        "valid": true,
         "issues": [
-          {
-            "message": "Unclosed Anchor: [DEF:AssistantChatIntegrationTest:Module] started at line 1",
-            "severity": "ERROR",
-            "line_number": 1
-          },
           {
             "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
             "severity": "WARNING",
             "line_number": 1
           }
         ],
-        "score": 0.0
+        "score": 0.775
+      }
+    },
+    {
+      "name": "AssistantClarificationIntegrationTest",
+      "type": "Module",
+      "complexity": 3,
+      "tier": "STANDARD",
+      "start_line": 1,
+      "end_line": 208,
+      "tags": {
+        "COMPLEXITY": "3",
+        "SEMANTICS": "assistant, clarification, integration-test, dataset-review, mixed-initiative",
+        "PURPOSE": "Verify AssistantChatPanel hosts the resumable dataset-review clarification flow inside the assistant drawer and refreshes workspace session state after answering.",
+        "LAYER": "UI Tests"
+      },
+      "relations": [
+        {
+          "type": "VERIFIES",
+          "target": "AssistantChatPanel"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [
+          {
+            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
+            "severity": "WARNING",
+            "line_number": 1
+          }
+        ],
+        "score": 0.775
       }
     },
     {
@@ -65570,36 +66747,25 @@
       "end_line": 83,
       "tags": {
         "COMPLEXITY": "3",
-        "PURPOSE": "Visual grid/matrix representing the health status of dashboards.",
-        "LAYER": "UI/Component",
+        "PURPOSE": "Visual grid summary representing dashboard health status counts.",
+        "LAYER": "UI",
         "UX_STATE": "Error -> Displays an error message with a retry option.",
-        "UX_REATIVITY": "State: $state, Derived: $derived.",
+        "UX_REACTIVITY": "Uses $derived to keep aggregate totals consistent with the count props.",
         "TYPE": "{{"
       },
       "relations": [
         {
-          "type": "USES",
-          "target": "App"
+          "type": "BINDS_TO",
+          "target": "i18n"
         }
       ],
       "children": [],
       "compliance": {
         "valid": true,
-        "issues": [
-          {
-            "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 1
-          }
-        ],
-        "score": 0.75
+        "issues": [],
+        "score": 0.9
       },
       "data_flow": [
-        {
-          "store": "state",
-          "type": "READS_FROM",
-          "line": 11
-        },
         {
           "store": "derived",
           "type": "READS_FROM",
@@ -65658,74 +66824,72 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 197,
+      "end_line": 198,
       "tags": {
         "COMPLEXITY": "3",
         "PURPOSE": "Form for creating and editing validation policies.",
-        "LAYER": "UI/Component",
+        "LAYER": "UI",
         "UX_STATE": "Submitting -> Disables inputs and shows a loading state.",
-        "UX_FEEDBACK": "Error -> Shows error messages on invalid fields.",
-        "UX_REATIVITY": "State: $state, Derived: $derived.",
+        "UX_FEEDBACK": "Error -> Invalid field or submit failures keep the draft visible for correction.",
+        "UX_REACTIVITY": "Uses $state for mutable form data and $derived values for window health checks.",
         "TYPE": "{{ policy: any, environments: any[], onSave: (p: any) => void, onCancel: () => void }} */"
       },
       "relations": [
         {
-          "type": "USES",
-          "target": "App"
+          "type": "DISPATCHES",
+          "target": "onSave"
+        },
+        {
+          "type": "DISPATCHES",
+          "target": "onCancel"
         }
       ],
       "children": [],
       "compliance": {
         "valid": true,
-        "issues": [
-          {
-            "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 1
-          }
-        ],
-        "score": 0.75
+        "issues": [],
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "state",
           "type": "READS_FROM",
-          "line": 12
+          "line": 13
         },
         {
           "store": "derived",
           "type": "READS_FROM",
-          "line": 12
+          "line": 13
         },
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 16
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 39
+          "line": 17
         },
         {
           "store": "state",
           "type": "WRITES_TO",
           "line": 40
         },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 41
+        },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 42
+          "line": 43
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 62
+          "line": 63
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 71
+          "line": 72
         }
       ]
     },
@@ -65735,7 +66899,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 197,
+      "end_line": 198,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/health/PolicyForm.svelte",
         "COMPLEXITY": "1",
@@ -65748,8 +66912,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 18,
-          "end_line": 18,
+          "start_line": 19,
+          "end_line": 19,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65767,8 +66931,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 22,
-          "end_line": 22,
+          "start_line": 23,
+          "end_line": 23,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65786,8 +66950,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 26,
-          "end_line": 26,
+          "start_line": 27,
+          "end_line": 27,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65805,8 +66969,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 73,
-          "end_line": 73,
+          "start_line": 74,
+          "end_line": 74,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65824,8 +66988,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 83,
-          "end_line": 83,
+          "start_line": 84,
+          "end_line": 84,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -65851,12 +67015,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 107,
+      "end_line": 101,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "SEMANTICS": "reports, card, type-profile, accessibility, fallback",
         "PURPOSE": "Render one report with explicit textual type label and profile-driven visual variant.",
@@ -65889,43 +67049,53 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 37
+          "line": 31
         },
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 40
+          "line": 34
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 42
+          "line": 36
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 43
+          "line": 37
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 60
+          "line": 54
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 61
+          "line": 55
         },
         {
           "store": "t",
           "type": "WRITES_TO",
+          "line": 56
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 57
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 58
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
           "line": 62
         },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 63
-        },
         {
           "store": "t",
           "type": "READS_FROM",
@@ -65933,38 +67103,28 @@
         },
         {
           "store": "t",
-          "type": "READS_FROM",
-          "line": 68
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 70
+          "type": "WRITES_TO",
+          "line": 78
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 84
+          "line": 78
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 84
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 84
+          "line": 78
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 91
+          "line": 85
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 102
+          "line": 96
         }
       ]
     },
@@ -65974,7 +67134,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 107,
+      "end_line": 101,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/reports/ReportCard.svelte",
         "COMPLEXITY": "1",
@@ -65987,8 +67147,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 47,
-          "end_line": 47,
+          "start_line": 41,
+          "end_line": 41,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -66006,8 +67166,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 59,
-          "end_line": 59,
+          "start_line": 53,
+          "end_line": 53,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -66025,8 +67185,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 67,
-          "end_line": 67,
+          "start_line": 61,
+          "end_line": 61,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -66044,8 +67204,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 74,
-          "end_line": 74,
+          "start_line": 68,
+          "end_line": 68,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -66071,12 +67231,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 56,
+      "end_line": 50,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "SEMANTICS": "reports, list, card, unified, mixed-types",
         "PURPOSE": "Render unified list of normalized reports with canonical minimum fields.",
@@ -66106,7 +67262,7 @@
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 38
+          "line": 32
         }
       ]
     },
@@ -66116,7 +67272,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 56,
+      "end_line": 50,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/reports/ReportsList.svelte",
         "COMPLEXITY": "1",
@@ -66129,8 +67285,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 40,
-          "end_line": 40,
+          "start_line": 34,
+          "end_line": 34,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -66234,12 +67390,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 113,
+      "end_line": 107,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "SEMANTICS": "reports, detail, diagnostics, next-actions, placeholders",
         "PURPOSE": "Display detailed report context with diagnostics and actionable recovery guidance.",
@@ -66268,12 +67420,17 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 36
+          "line": 30
         },
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 38
+          "line": 32
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 36
         },
         {
           "store": "t",
@@ -66283,62 +67440,57 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 48
+          "line": 44
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 50
+          "line": 51
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 55
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 59
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 63
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 67
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 71
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 75
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 57
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 61
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 65
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 69
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 73
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 77
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 81
+          "line": 82
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 88
+          "line": 86
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 92
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 101
+          "line": 95
         }
       ]
     },
@@ -66348,7 +67500,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 113,
+      "end_line": 107,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/reports/ReportDetailPanel.svelte",
         "COMPLEXITY": "1",
@@ -66361,8 +67513,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 40,
-          "end_line": 40,
+          "start_line": 34,
+          "end_line": 34,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -66380,8 +67532,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 47,
-          "end_line": 47,
+          "start_line": 41,
+          "end_line": 41,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -66588,36 +67740,30 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 4,
-      "end_line": null,
+      "end_line": 80,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "reports, list, ux-tests, events, iteration",
         "PURPOSE": "Test ReportsList component iteration and event forwarding.",
         "LAYER": "UI",
+        "TEST_CONTRACT": "Component_ReportsList -> Forwards select events from children.",
+        "TEST_SCENARIO": "forwards_select_event -> Child click forwards select payload to parent listener.",
+        "TEST_FIXTURE": "renders_list -> INLINE_JSON",
+        "TEST_INVARIANT": "correct_iteration -> VERIFIED_BY: [renders_report_cards_for_each_item, renders_empty_list_container]",
+        "TEST_EDGE": "empty_list -> Empty reports array keeps container stable.",
         "UX_FEEDBACK": "Click on report emits select event."
       },
       "relations": [
         {
-          "type": "VERIFIES",
-          "target": "../ReportsList.svelte"
+          "type": "DEPENDS_ON",
+          "target": "ReportsList"
         }
       ],
       "children": [],
       "compliance": {
-        "valid": false,
-        "issues": [
-          {
-            "message": "Unclosed Anchor: [DEF:ReportsListTest:Module] started at line 4",
-            "severity": "ERROR",
-            "line_number": 4
-          },
-          {
-            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 4
-          }
-        ],
-        "score": 0.0
+        "valid": true,
+        "issues": [],
+        "score": 0.925
       }
     },
     {
@@ -66811,7 +67957,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 612,
+      "end_line": 676,
       "tags": {
         "COMPLEXITY": "4 -->",
         "SEMANTICS": "dataset-review, semantic-layer, candidate-review, manual-override, field-lock -->",
@@ -66871,23 +68017,8 @@
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 27
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 29
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
           "line": 30
         },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 31
-        },
         {
           "store": "state",
           "type": "WRITES_TO",
@@ -66909,79 +68040,84 @@
           "line": 35
         },
         {
-          "store": "derived",
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 36
+        },
+        {
+          "store": "state",
           "type": "WRITES_TO",
           "line": 37
         },
         {
-          "store": "derived",
+          "store": "state",
           "type": "WRITES_TO",
-          "line": 49
+          "line": 38
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 50
+          "line": 40
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 52
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 53
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 96
+          "line": 99
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 103
+          "line": 106
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 108
+          "line": 111
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 113
+          "line": 116
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 115
+          "line": 118
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 120
+          "line": 123
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 143
+          "line": 147
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 154
+          "line": 161
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 155
+          "line": 162
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 186
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 211
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 212
+          "line": 193
         },
         {
           "store": "t",
@@ -66996,202 +68132,222 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 255
+          "line": 232
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 256
+          "line": 233
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 283
+          "line": 268
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 284
+          "line": 269
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 291
+          "line": 297
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 292
+          "line": 298
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 304
+          "line": 305
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 307
+          "line": 306
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 310
+          "line": 347
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 317
+          "line": 350
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 331
+          "line": 353
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 338
+          "line": 360
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 375
+          "line": 374
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 376
+          "line": 381
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 380
+          "line": 423
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 385
+          "line": 424
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 392
+          "line": 428
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 399
+          "line": 433
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 403
+          "line": 440
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 408
+          "line": 447
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 412
+          "line": 451
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 421
+          "line": 456
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 432
+          "line": 460
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 443
+          "line": 469
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 459
+          "line": 480
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 467
+          "line": 491
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 476
+          "line": 507
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 485
+          "line": 515
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 496
+          "line": 524
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 502
+          "line": 533
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 512
+          "line": 544
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 517
+          "line": 550
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 530
+          "line": 560
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 538
+          "line": 565
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 559
+          "line": 578
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 572
+          "line": 586
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 582
+          "line": 607
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 583
+          "line": 620
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 593
+          "line": 628
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 601
+          "line": 636
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 646
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 647
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 657
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 665
         }
       ]
     },
@@ -67201,7 +68357,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 612,
+      "end_line": 676,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/dataset-review/SemanticLayerReview.svelte",
         "COMPLEXITY": "1",
@@ -67214,8 +68370,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 54,
-          "end_line": 54,
+          "start_line": 57,
+          "end_line": 57,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67233,8 +68389,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 64,
-          "end_line": 64,
+          "start_line": 67,
+          "end_line": 67,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67252,8 +68408,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 74,
-          "end_line": 74,
+          "start_line": 77,
+          "end_line": 77,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67271,8 +68427,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 82,
-          "end_line": 82,
+          "start_line": 85,
+          "end_line": 85,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67290,8 +68446,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 93,
-          "end_line": 93,
+          "start_line": 96,
+          "end_line": 96,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67309,8 +68465,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 101,
-          "end_line": 101,
+          "start_line": 104,
+          "end_line": 104,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67328,8 +68484,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 106,
-          "end_line": 106,
+          "start_line": 109,
+          "end_line": 109,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67347,8 +68503,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 111,
-          "end_line": 111,
+          "start_line": 114,
+          "end_line": 114,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67366,8 +68522,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 118,
-          "end_line": 118,
+          "start_line": 121,
+          "end_line": 121,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67385,8 +68541,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 127,
-          "end_line": 127,
+          "start_line": 130,
+          "end_line": 130,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67404,8 +68560,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 162,
-          "end_line": 162,
+          "start_line": 169,
+          "end_line": 169,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67423,8 +68579,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 173,
-          "end_line": 173,
+          "start_line": 180,
+          "end_line": 180,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67442,8 +68598,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 194,
-          "end_line": 194,
+          "start_line": 201,
+          "end_line": 201,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67461,8 +68617,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 228,
-          "end_line": 228,
+          "start_line": 240,
+          "end_line": 240,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67480,8 +68636,65 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 265,
-          "end_line": 265,
+          "start_line": 278,
+          "end_line": 278,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "isFieldFocused",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 313,
+          "end_line": 313,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "askAiAboutField",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 318,
+          "end_line": 318,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "improveFieldDraft",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 331,
+          "end_line": 331,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -67499,7 +68712,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 612 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 676 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -67983,533 +69196,13 @@
         "score": 0.85
       }
     },
-    {
-      "name": "ClarificationDialog",
-      "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 1,
-      "end_line": 487,
-      "tags": {
-        "COMPLEXITY": "4 -->",
-        "SEMANTICS": "dataset-review, clarification, single-question, resumable, expert-review -->",
-        "PURPOSE": "Present one clarification question at a time with explicit why-it-matters context, answer actions, and resumable state transitions for US2. -->",
-        "LAYER": "UI -->",
-        "PRE": "Session id is available and clarification state payload belongs to the current ownership-scoped session. -->",
-        "POST": "Users can answer, skip, or route to expert review while the UI keeps only the active clarification question visible and preserves resumable progress. -->",
-        "SIDE_EFFECT": "Persists clarification answers and may resume clarification state from dataset orchestration APIs. -->",
-        "DATA_CONTRACT": "Input -> Dataset review clarification state { sessionId, clarificationState.current_question, clarificationState.clarification_session }; Output -> onupdated(nextClarificationState) refresh payload plus optional question feedback mutation. -->",
-        "UX_STATE": "Completed -> No active question remains and resumable clarification summary stays visible. -->",
-        "UX_FEEDBACK": "Save results and changed findings surface inline without hiding the active or completed state. -->",
-        "UX_RECOVERY": "Users can resume clarification after interruption, skip uncertain questions, or open assistant guidance before escalating to expert review. -->",
-        "UX_REACTIVITY": "Uses $props, $state, and $derived only; no legacy reactive syntax. -->"
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "api_module"
-        },
-        {
-          "type": "BINDS_TO",
-          "target": "assistantChat"
-        },
-        {
-          "type": "BINDS_TO",
-          "target": "DatasetReviewWorkspace"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      },
-      "data_flow": [
-        {
-          "store": "props",
-          "type": "READS_FROM",
-          "line": 18
-        },
-        {
-          "store": "state",
-          "type": "READS_FROM",
-          "line": 18
-        },
-        {
-          "store": "derived",
-          "type": "READS_FROM",
-          "line": 18
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 20
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 21
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 22
-        },
-        {
-          "store": "props",
-          "type": "WRITES_TO",
-          "line": 29
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 31
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 32
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 33
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 34
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 35
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 36
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 37
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 38
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 39
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 41
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 42
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 43
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 46
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 47
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 54
-        },
-        {
-          "store": "effect",
-          "type": "READS_FROM",
-          "line": 62
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 115
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 116
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 121
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 122
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 143
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 149
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 150
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 165
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 171
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 196
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 199
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 201
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 209
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 210
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 219
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 227
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 230
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 233
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 239
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 243
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 251
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 254
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 258
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 274
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 282
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 290
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 294
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 300
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 308
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 339
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 352
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 369
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 378
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 387
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 396
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 405
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 412
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 422
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 431
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 441
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 445
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 455
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 463
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 481
-        }
-      ]
-    },
-    {
-      "name": "ClarificationDialog",
-      "type": "Module",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 1,
-      "end_line": 487,
-      "tags": {
-        "PURPOSE": "Auto-generated module for frontend/src/lib/components/dataset-review/ClarificationDialog.svelte",
-        "COMPLEXITY": "1",
-        "LAYER": "Unknown"
-      },
-      "relations": [],
-      "children": [
-        {
-          "name": "clearFeedback",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 82,
-          "end_line": 82,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "normalizeAnswerValue",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 87,
-          "end_line": 87,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "recordClarificationFeedback",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 97,
-          "end_line": 97,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "resumeClarification",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 128,
-          "end_line": 128,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "submitAnswer",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 156,
-          "end_line": 156,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "requestAssistantGuidance",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 216,
-          "end_line": 216,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        }
-      ],
-      "compliance": {
-        "valid": true,
-        "issues": [
-          {
-            "message": "Fractal limit warning: Module length is 487 lines (must be < 300)",
-            "severity": "WARNING",
-            "line_number": 1
-          }
-        ],
-        "score": 0.85
-      }
-    },
     {
       "name": "CompiledSQLPreview",
       "type": "Component",
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 267,
+      "end_line": 328,
       "tags": {
         "COMPLEXITY": "4 -->",
         "SEMANTICS": "dataset-review, compiled-sql-preview, superset-preview, stale-state, diagnostics -->",
@@ -68569,67 +69262,67 @@
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 31
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
           "line": 33
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 34
+          "line": 35
         },
         {
-          "store": "derived",
+          "store": "state",
           "type": "WRITES_TO",
           "line": 36
         },
         {
-          "store": "derived",
+          "store": "state",
           "type": "WRITES_TO",
           "line": 37
         },
         {
-          "store": "derived",
+          "store": "state",
           "type": "WRITES_TO",
           "line": 38
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 39
+          "line": 42
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 40
+          "line": 43
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 44
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 45
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 46
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 63
+          "line": 69
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 84
+          "line": 90
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 86
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 91
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 94
+          "line": 92
         },
         {
           "store": "t",
@@ -68644,42 +69337,42 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 102
+          "line": 103
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 106
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 108
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 109
+          "line": 115
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 116
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 129
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 130
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 135
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 136
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 149
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
           "line": 152
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 155
+          "line": 160
         },
         {
           "store": "t",
@@ -68689,12 +69382,17 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 170
+          "line": 187
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 171
+          "line": 190
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 193
         },
         {
           "store": "t",
@@ -68704,37 +69402,57 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 202
+          "line": 208
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 206
+          "line": 209
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 216
+          "line": 217
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 219
+          "line": 257
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 228
+          "line": 260
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 239
+          "line": 264
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 249
+          "line": 274
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 277
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 286
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 297
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 310
         }
       ]
     },
@@ -68744,7 +69462,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 267,
+      "end_line": 328,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/dataset-review/CompiledSQLPreview.svelte",
         "COMPLEXITY": "1",
@@ -68757,8 +69475,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 44,
-          "end_line": 44,
+          "start_line": 50,
+          "end_line": 50,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -68776,8 +69494,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 62,
-          "end_line": 62,
+          "start_line": 68,
+          "end_line": 68,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -68795,8 +69513,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 66,
-          "end_line": 66,
+          "start_line": 72,
+          "end_line": 72,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -68814,8 +69532,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 82,
-          "end_line": 82,
+          "start_line": 88,
+          "end_line": 88,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -68833,8 +69551,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 89,
-          "end_line": 89,
+          "start_line": 95,
+          "end_line": 95,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -68852,25 +69570,6 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 105,
-          "end_line": 105,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "requestPreview",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
           "start_line": 111,
           "end_line": 111,
           "tags": {
@@ -68885,13 +69584,51 @@
             "score": 1.0
           }
         },
+        {
+          "name": "requestPreview",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 120,
+          "end_line": 120,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "jumpToMapping",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 140,
-          "end_line": 140,
+          "start_line": 165,
+          "end_line": 165,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "askAiAboutPreview",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 169,
+          "end_line": 169,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -68907,8 +69644,14 @@
       ],
       "compliance": {
         "valid": true,
-        "issues": [],
-        "score": 1.0
+        "issues": [
+          {
+            "message": "Fractal limit warning: Module length is 328 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 1
+          }
+        ],
+        "score": 0.85
       }
     },
     {
@@ -68917,7 +69660,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 357,
+      "end_line": 461,
       "tags": {
         "COMPLEXITY": "3 -->",
         "SEMANTICS": "dataset-review, findings, severity, readiness, actionability -->",
@@ -68959,18 +69702,8 @@
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 21
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
           "line": 23
         },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 24
-        },
         {
           "store": "derived",
           "type": "WRITES_TO",
@@ -68989,52 +69722,47 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 30
+          "line": 28
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 29
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 32
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 79
+          "line": 81
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 84
+          "line": 86
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 89
+          "line": 91
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 109
+          "line": 140
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 112
+          "line": 142
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 115
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 121
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 137
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 144
+          "line": 150
         },
         {
           "store": "t",
@@ -69044,7 +69772,17 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 179
+          "line": 156
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 162
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 178
         },
         {
           "store": "t",
@@ -69054,17 +69792,17 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 202
+          "line": 194
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 215
+          "line": 227
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 224
+          "line": 233
         },
         {
           "store": "t",
@@ -69074,12 +69812,17 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 256
+          "line": 257
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 273
+          "line": 264
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 277
         },
         {
           "store": "t",
@@ -69089,22 +69832,62 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 295
+          "line": 319
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 321
+          "line": 325
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 327
+          "line": 342
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 344
+          "line": 349
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 356
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 369
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 378
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 411
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 417
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 434
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 441
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 448
         }
       ]
     },
@@ -69114,7 +69897,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 357,
+      "end_line": 461,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/dataset-review/ValidationFindingsPanel.svelte",
         "COMPLEXITY": "1",
@@ -69127,8 +69910,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 38,
-          "end_line": 38,
+          "start_line": 40,
+          "end_line": 40,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69146,8 +69929,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 57,
-          "end_line": 57,
+          "start_line": 59,
+          "end_line": 59,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69165,8 +69948,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 70,
-          "end_line": 70,
+          "start_line": 72,
+          "end_line": 72,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69184,8 +69967,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 77,
-          "end_line": 77,
+          "start_line": 79,
+          "end_line": 79,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69203,8 +69986,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 82,
-          "end_line": 82,
+          "start_line": 84,
+          "end_line": 84,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69222,8 +70005,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 87,
-          "end_line": 87,
+          "start_line": 89,
+          "end_line": 89,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69241,8 +70024,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 92,
-          "end_line": 92,
+          "start_line": 94,
+          "end_line": 94,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69260,8 +70043,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 96,
-          "end_line": 96,
+          "start_line": 98,
+          "end_line": 98,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69279,8 +70062,103 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 100,
-          "end_line": 100,
+          "start_line": 102,
+          "end_line": 102,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "isFindingFocused",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 106,
+          "end_line": 106,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "getFindingFocusTarget",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 111,
+          "end_line": 111,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "askAiAboutFinding",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 115,
+          "end_line": 115,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "improveFindingGuidance",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 126,
+          "end_line": 126,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "getContextActionLabel",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 137,
+          "end_line": 137,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69298,7 +70176,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 357 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 461 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -69312,7 +70190,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 382,
+      "end_line": 391,
       "tags": {
         "COMPLEXITY": "4 -->",
         "SEMANTICS": "dataset-review, launch-confirmation, run-gates, sql-lab, audited-execution -->",
@@ -69372,12 +70250,7 @@
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 33
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 35
+          "line": 34
         },
         {
           "store": "state",
@@ -69390,9 +70263,9 @@
           "line": 37
         },
         {
-          "store": "derived",
+          "store": "state",
           "type": "WRITES_TO",
-          "line": 39
+          "line": 38
         },
         {
           "store": "derived",
@@ -69402,12 +70275,12 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 43
+          "line": 41
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 46
+          "line": 44
         },
         {
           "store": "derived",
@@ -69417,12 +70290,12 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 50
+          "line": 48
         },
         {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 52
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 51
         },
         {
           "store": "t",
@@ -69432,62 +70305,62 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 67
+          "line": 54
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 79
+          "line": 68
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 90
+          "line": 80
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 98
+          "line": 91
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 106
+          "line": 99
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 114
+          "line": 107
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 124
+          "line": 115
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 134
+          "line": 125
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 145
+          "line": 135
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 146
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 174
+          "line": 180
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 183
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 184
+          "line": 192
         },
         {
           "store": "t",
@@ -69497,42 +70370,37 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 196
+          "line": 202
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 199
+          "line": 205
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 204
+          "line": 208
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 211
+          "line": 213
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 214
+          "line": 220
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 238
+          "line": 223
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 252
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 255
+          "line": 247
         },
         {
           "store": "t",
@@ -69549,6 +70417,11 @@
           "type": "READS_FROM",
           "line": 270
         },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 273
+        },
         {
           "store": "t",
           "type": "READS_FROM",
@@ -69557,42 +70430,42 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 282
+          "line": 288
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 290
+          "line": 291
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 293
+          "line": 299
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 297
+          "line": 302
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 300
+          "line": 306
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 320
+          "line": 309
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 323
+          "line": 329
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 330
+          "line": 332
         },
         {
           "store": "t",
@@ -69608,6 +70481,11 @@
           "store": "t",
           "type": "READS_FROM",
           "line": 357
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 366
         }
       ]
     },
@@ -69617,7 +70495,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 382,
+      "end_line": 391,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/dataset-review/LaunchConfirmationPanel.svelte",
         "COMPLEXITY": "1",
@@ -69630,8 +70508,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 56,
-          "end_line": 56,
+          "start_line": 57,
+          "end_line": 57,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69649,8 +70527,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 144,
-          "end_line": 144,
+          "start_line": 145,
+          "end_line": 145,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69668,8 +70546,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 148,
-          "end_line": 148,
+          "start_line": 149,
+          "end_line": 149,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69687,8 +70565,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 158,
-          "end_line": 158,
+          "start_line": 159,
+          "end_line": 159,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69706,8 +70584,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 162,
-          "end_line": 162,
+          "start_line": 163,
+          "end_line": 163,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -69725,7 +70603,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 382 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 391 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -69739,7 +70617,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 579,
+      "end_line": 647,
       "tags": {
         "COMPLEXITY": "4 -->",
         "SEMANTICS": "dataset-review, execution-mapping, warning-approval, manual-override, required-values -->",
@@ -69799,23 +70677,8 @@
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 29
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 31
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
           "line": 32
         },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 33
-        },
         {
           "store": "state",
           "type": "WRITES_TO",
@@ -69832,10 +70695,20 @@
           "line": 36
         },
         {
-          "store": "derived",
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 37
+        },
+        {
+          "store": "state",
           "type": "WRITES_TO",
           "line": 38
         },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 39
+        },
         {
           "store": "derived",
           "type": "WRITES_TO",
@@ -69844,12 +70717,12 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 45
+          "line": 44
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 71
+          "line": 48
         },
         {
           "store": "derived",
@@ -69862,74 +70735,69 @@
           "line": 77
         },
         {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 104
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 80
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 109
+          "line": 107
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 114
+          "line": 112
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 119
+          "line": 117
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 214
+          "line": 122
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 225
+          "line": 218
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 226
+          "line": 232
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 255
+          "line": 233
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 256
+          "line": 266
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 275
+          "line": 267
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 295
+          "line": 286
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 309
+          "line": 307
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 310
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 322
+          "line": 324
         },
         {
           "store": "t",
@@ -69939,127 +70807,87 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 328
+          "line": 367
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 342
+          "line": 370
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 342
+          "line": 373
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 345
+          "line": 387
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 348
+          "line": 387
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 356
+          "line": 390
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 363
+          "line": 393
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 368
+          "line": 401
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 377
+          "line": 408
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 409
+          "line": 413
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 414
+          "line": 422
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 419
+          "line": 461
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 424
+          "line": 466
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 432
+          "line": 471
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 439
+          "line": 476
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 443
+          "line": 484
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 444
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 447
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 448
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 455
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 462
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 465
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 469
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 479
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 487
+          "line": 491
         },
         {
           "store": "t",
@@ -70069,17 +70897,47 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 506
+          "line": 496
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 522
+          "line": 499
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 530
+          "line": 500
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 507
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 514
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 517
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 521
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 531
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 539
         },
         {
           "store": "t",
@@ -70089,12 +70947,42 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 560
+          "line": 558
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 569
+          "line": 574
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 582
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 599
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 612
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 620
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 628
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 637
         }
       ]
     },
@@ -70104,7 +70992,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 579,
+      "end_line": 647,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/dataset-review/ExecutionMappingReview.svelte",
         "COMPLEXITY": "1",
@@ -70117,8 +71005,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 85,
-          "end_line": 85,
+          "start_line": 88,
+          "end_line": 88,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70136,8 +71024,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 95,
-          "end_line": 95,
+          "start_line": 98,
+          "end_line": 98,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70155,8 +71043,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 102,
-          "end_line": 102,
+          "start_line": 105,
+          "end_line": 105,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70174,8 +71062,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 107,
-          "end_line": 107,
+          "start_line": 110,
+          "end_line": 110,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70193,8 +71081,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 112,
-          "end_line": 112,
+          "start_line": 115,
+          "end_line": 115,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70212,8 +71100,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 117,
-          "end_line": 117,
+          "start_line": 120,
+          "end_line": 120,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70231,8 +71119,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 131,
-          "end_line": 131,
+          "start_line": 134,
+          "end_line": 134,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70250,8 +71138,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 150,
-          "end_line": 150,
+          "start_line": 153,
+          "end_line": 153,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70269,8 +71157,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 166,
-          "end_line": 166,
+          "start_line": 169,
+          "end_line": 169,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70288,8 +71176,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 175,
-          "end_line": 175,
+          "start_line": 178,
+          "end_line": 178,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70307,8 +71195,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 185,
-          "end_line": 185,
+          "start_line": 188,
+          "end_line": 188,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70326,8 +71214,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 198,
-          "end_line": 198,
+          "start_line": 201,
+          "end_line": 201,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70345,8 +71233,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 233,
-          "end_line": 233,
+          "start_line": 240,
+          "end_line": 240,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70364,8 +71252,65 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 265,
-          "end_line": 265,
+          "start_line": 276,
+          "end_line": 276,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "isMappingFocused",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 332,
+          "end_line": 332,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "askAiAboutMapping",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 337,
+          "end_line": 337,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "improveMappingDraft",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 350,
+          "end_line": 350,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -70383,7 +71328,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 579 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 647 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -70428,58 +71373,6 @@
         "score": 0.775
       }
     },
-    {
-      "name": "DatasetReviewUs2UxTests",
-      "type": "Module",
-      "complexity": 3,
-      "tier": "STANDARD",
-      "start_line": 5,
-      "end_line": 412,
-      "tags": {
-        "COMPLEXITY": "3",
-        "SEMANTICS": "dataset-review, semantics, clarification, ux-tests, field-review",
-        "PURPOSE": "Verify US2 semantic field review and one-question clarification UX contracts.",
-        "LAYER": "UI",
-        "UX_STATE": "Question -> Clarification shows one active question, why-it-matters context, and resumable actions.",
-        "TEST_CONTRACT": "Us2DatasetReviewProps -> ObservableSemanticAndClarificationUx",
-        "TEST_SCENARIO": "clarification_dialog_shows_active_question_and_actions -> Clarification dialog renders one active question with answer and escalation actions.",
-        "TEST_EDGE": "external_fail -> Failed request surfaces inline recovery message.",
-        "TEST_INVARIANT": "us2_components_remain_actionable -> VERIFIED_BY: [semantic_review_surfaces_active_value_and_candidates, clarification_dialog_shows_active_question_and_actions]",
-        "TYPE": "{any} */ (openAssistantChat);"
-      },
-      "relations": [
-        {
-          "type": "VERIFIES",
-          "target": "SemanticLayerReview"
-        },
-        {
-          "type": "VERIFIES",
-          "target": "ClarificationDialog"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [
-          {
-            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 5
-          },
-          {
-            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 5
-          },
-          {
-            "message": "Fractal limit warning: Module length is 408 lines (must be < 300)",
-            "severity": "WARNING",
-            "line_number": 5
-          }
-        ],
-        "score": 0.47500000000000003
-      }
-    },
     {
       "name": "DatasetReviewUs3UxTests",
       "type": "Module",
@@ -70540,6 +71433,54 @@
         "score": 0.325
       }
     },
+    {
+      "name": "DatasetReviewUs2WorkspaceUxTests",
+      "type": "Module",
+      "complexity": 3,
+      "tier": "STANDARD",
+      "start_line": 5,
+      "end_line": 311,
+      "tags": {
+        "COMPLEXITY": "3",
+        "SEMANTICS": "dataset-review, semantics, assistant, workspace, ux-tests, mapping-review",
+        "PURPOSE": "Verify US2 dataset review surfaces keep semantic review actionable, route clarification through AssistantChatPanel, and preserve explicit preview/mapping gates.",
+        "LAYER": "UI",
+        "TEST_SCENARIO": "mapping_review_marks_row_focused_and_requires_explicit_approval -> Mapping review keeps warning approvals explicit and highlightable.",
+        "TEST_EDGE": "external_fail -> Failed request surfaces inline recovery message."
+      },
+      "relations": [
+        {
+          "type": "VERIFIES",
+          "target": "SemanticLayerReview"
+        },
+        {
+          "type": "VERIFIES",
+          "target": "ExecutionMappingReview"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [
+          {
+            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
+            "severity": "WARNING",
+            "line_number": 5
+          },
+          {
+            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
+            "severity": "WARNING",
+            "line_number": 5
+          },
+          {
+            "message": "Fractal limit warning: Module length is 307 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 5
+          }
+        ],
+        "score": 0.47500000000000003
+      }
+    },
     {
       "name": "ValidationFindingsPanelUxTests",
       "type": "Module",
@@ -70583,18 +71524,19 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 335,
+      "end_line": 339,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "PURPOSE": "Persistent left sidebar with resource categories navigation",
         "LAYER": "UI",
         "SEMANTICS": "Navigation",
+        "PRE": "Sidebar store and translated category definitions are available before navigation is rendered.",
+        "POST": "Active category and item remain aligned with the current route and mobile state is dismissible.",
+        "SIDE_EFFECT": "Persists sidebar state via store actions, refreshes health indicators, and updates window location on navigation.",
+        "DATA_CONTRACT": "SidebarCategory[] -> RenderedNavigationTree",
         "INVARIANT": "Always shows active category and item",
-        "UX_STATE": "Toggling -> Animation plays for 200ms",
+        "UX_REACTIVITY": "Uses $derived for store-backed navigation state and $effect guards for route/category coherence.",
+        "UX_STATE": "MobileOpen -> Overlay and sidebar stay visible on small screens until dismissed.",
         "UX_FEEDBACK": "Active item highlighted with different background",
         "UX_RECOVERY": "Click outside on mobile closes overlay",
         "TEST_CONTRACT": "Component_Sidebar ->",
@@ -70606,6 +71548,22 @@
         {
           "type": "BINDS_TO",
           "target": "sidebar"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "auth"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "health_store"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "SidebarNavigation"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "Icon"
         }
       ],
       "children": [],
@@ -70618,22 +71576,7 @@
         {
           "store": "app",
           "type": "READS_FROM",
-          "line": 37
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 44
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 45
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 47
+          "line": 41
         },
         {
           "store": "lib",
@@ -70645,302 +71588,6 @@
           "type": "READS_FROM",
           "line": 49
         },
-        {
-          "store": "app",
-          "type": "READS_FROM",
-          "line": 50
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 51
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 58
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 65
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 66
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 69
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 70
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 71
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 72
-        },
-        {
-          "store": "effect",
-          "type": "READS_FROM",
-          "line": 91
-        },
-        {
-          "store": "effect",
-          "type": "READS_FROM",
-          "line": 104
-        },
-        {
-          "store": "effect",
-          "type": "READS_FROM",
-          "line": 111
-        },
-        {
-          "store": "effect",
-          "type": "READS_FROM",
-          "line": 171
-        }
-      ]
-    },
-    {
-      "name": "Sidebar",
-      "type": "Module",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 1,
-      "end_line": 335,
-      "tags": {
-        "PURPOSE": "Auto-generated module for frontend/src/lib/components/layout/Sidebar.svelte",
-        "COMPLEXITY": "1",
-        "LAYER": "Unknown"
-      },
-      "relations": [],
-      "children": [
-        {
-          "name": "withExpandedCategory",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 74,
-          "end_line": 74,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "toggleExpandedCategory",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 80,
-          "end_line": 80,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleItemClick",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 125,
-          "end_line": 125,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleCategoryToggle",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 134,
-          "end_line": 134,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleSubItemClick",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 150,
-          "end_line": 150,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleToggleClick",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 159,
-          "end_line": 159,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleOverlayClick",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 165,
-          "end_line": 165,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        }
-      ],
-      "compliance": {
-        "valid": true,
-        "issues": [
-          {
-            "message": "Fractal limit warning: Module length is 335 lines (must be < 300)",
-            "severity": "WARNING",
-            "line_number": 1
-          }
-        ],
-        "score": 0.85
-      }
-    },
-    {
-      "name": "TopNavbar",
-      "type": "Component",
-      "complexity": 3,
-      "tier": "STANDARD",
-      "start_line": 1,
-      "end_line": 575,
-      "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
-        "COMPLEXITY": "5",
-        "PURPOSE": "Unified top navigation bar with Logo, Search, Activity, and User menu",
-        "LAYER": "UI",
-        "SEMANTICS": "Navigation, UserSession",
-        "INVARIANT": "Always visible on non-login pages",
-        "UX_STATE": "SearchFocused -> Search input expands",
-        "UX_FEEDBACK": "Activity badge shows count of running tasks",
-        "UX_RECOVERY": "Click outside closes dropdowns",
-        "UX_TEST": "ActivityClick -> {click: activity button, expected: task drawer opens}",
-        "TEST_CONTRACT": "Component_TopNavbar ->",
-        "TEST_FIXTURE": "logged_in -> {\"user\": {\"username\": \"admin\"}}",
-        "TEST_EDGE": "network_down -> search fetch fails, handles error state",
-        "TEST_INVARIANT": "ui_consistency -> verifies: [logged_in]"
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "activity"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 0.9
-      },
-      "data_flow": [
-        {
-          "store": "app",
-          "type": "READS_FROM",
-          "line": 40
-        },
-        {
-          "store": "app",
-          "type": "READS_FROM",
-          "line": 41
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 42
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 43
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 44
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 50
-        },
         {
           "store": "lib",
           "type": "READS_FROM",
@@ -70957,7 +71604,7 @@
           "line": 53
         },
         {
-          "store": "lib",
+          "store": "app",
           "type": "READS_FROM",
           "line": 54
         },
@@ -70967,208 +71614,83 @@
           "line": 55
         },
         {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 56
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 57
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 63
-        },
-        {
-          "store": "state",
+          "store": "derived",
           "type": "WRITES_TO",
-          "line": 66
+          "line": 62
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 67
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 68
-        },
-        {
-          "store": "state",
+          "store": "derived",
           "type": "WRITES_TO",
           "line": 69
         },
         {
-          "store": "state",
+          "store": "derived",
           "type": "WRITES_TO",
           "line": 70
         },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 73
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 74
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 75
+        },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 71
+          "line": 76
         },
         {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 84
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 85
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 86
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 87
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 88
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 91
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 94
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 97
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 98
-        },
-        {
-          "store": "t",
+          "store": "effect",
           "type": "READS_FROM",
-          "line": 235
+          "line": 95
         },
         {
-          "store": "t",
+          "store": "effect",
           "type": "READS_FROM",
-          "line": 242
+          "line": 108
         },
         {
-          "store": "t",
+          "store": "effect",
           "type": "READS_FROM",
-          "line": 249
+          "line": 115
         },
         {
-          "store": "t",
+          "store": "effect",
           "type": "READS_FROM",
-          "line": 256
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 379
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 394
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 406
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 418
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 422
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 465
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 466
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 490
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 491
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 504
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 524
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 542
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 557
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 568
+          "line": 175
         }
       ]
     },
     {
-      "name": "TopNavbar",
+      "name": "Sidebar",
       "type": "Module",
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 575,
+      "end_line": 339,
       "tags": {
-        "PURPOSE": "Auto-generated module for frontend/src/lib/components/layout/TopNavbar.svelte",
+        "PURPOSE": "Auto-generated module for frontend/src/lib/components/layout/Sidebar.svelte",
         "COMPLEXITY": "1",
         "LAYER": "Unknown"
       },
       "relations": [],
       "children": [
         {
-          "name": "toggleUserMenu",
+          "name": "withExpandedCategory",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 103,
-          "end_line": 103,
+          "start_line": 78,
+          "end_line": 78,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71182,12 +71704,12 @@
           }
         },
         {
-          "name": "closeUserMenu",
+          "name": "toggleExpandedCategory",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 108,
-          "end_line": 108,
+          "start_line": 84,
+          "end_line": 84,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71201,45 +71723,7 @@
           }
         },
         {
-          "name": "handleLogout",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 112,
-          "end_line": 112,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleActivityClick",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 118,
-          "end_line": 118,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleAssistantClick",
+          "name": "handleItemClick",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
@@ -71257,13 +71741,512 @@
             "score": 1.0
           }
         },
+        {
+          "name": "handleCategoryToggle",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 138,
+          "end_line": 138,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleSubItemClick",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 154,
+          "end_line": 154,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleToggleClick",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 163,
+          "end_line": 163,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleOverlayClick",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 169,
+          "end_line": 169,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        }
+      ],
+      "compliance": {
+        "valid": true,
+        "issues": [
+          {
+            "message": "Fractal limit warning: Module length is 339 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 1
+          }
+        ],
+        "score": 0.85
+      }
+    },
+    {
+      "name": "TopNavbar",
+      "type": "Component",
+      "complexity": 3,
+      "tier": "STANDARD",
+      "start_line": 1,
+      "end_line": 581,
+      "tags": {
+        "COMPLEXITY": "5",
+        "PURPOSE": "Unified top navigation bar with Logo, Search, Activity, and User menu",
+        "LAYER": "UI",
+        "SEMANTICS": "Navigation, UserSession",
+        "PRE": "Auth, environment, and task stores are initialized before interactive navbar actions are used.",
+        "POST": "Search, environment selection, and global action controls remain synchronized with current app state.",
+        "SIDE_EFFECT": "Reads profile preferences, performs search API requests, and triggers drawer, auth, and assistant actions.",
+        "DATA_CONTRACT": "SearchQuery -> SearchSection[] | ProfilePreferences -> TaskDrawerPreference",
+        "INVARIANT": "Always visible on non-login pages",
+        "UX_REACTIVITY": "Uses $state for menu/search state and $derived projections from app stores.",
+        "UX_STATE": "Searching -> Search dropdown stays open while async results are loading.",
+        "UX_FEEDBACK": "Activity badge shows count of running tasks",
+        "UX_RECOVERY": "Click outside closes dropdowns",
+        "UX_TEST": "ActivityClick -> {click: activity button, expected: task drawer opens}",
+        "TEST_CONTRACT": "Component_TopNavbar ->",
+        "TEST_FIXTURE": "logged_in -> {\"user\": {\"username\": \"admin\"}}",
+        "TEST_EDGE": "network_down -> search fetch fails, handles error state",
+        "TEST_INVARIANT": "ui_consistency -> verifies: [logged_in]"
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "activity"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "auth"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "environmentContext"
+        },
+        {
+          "type": "DISPATCHES",
+          "target": "taskDrawer"
+        },
+        {
+          "type": "DISPATCHES",
+          "target": "assistantChat"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "Icon"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "LanguageSwitcher"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 0.9
+      },
+      "data_flow": [
+        {
+          "store": "app",
+          "type": "READS_FROM",
+          "line": 46
+        },
+        {
+          "store": "app",
+          "type": "READS_FROM",
+          "line": 47
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 48
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 49
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 50
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 56
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 57
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 58
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 59
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 60
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 61
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 62
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 63
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 69
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 72
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 73
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 74
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 75
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 76
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 77
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 90
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 91
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 92
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 93
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 94
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 97
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 100
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 103
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 104
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 241
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 248
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 255
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 262
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 385
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 400
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 412
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 424
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 428
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 471
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 472
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 496
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 497
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 510
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 530
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 548
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 563
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 574
+        }
+      ]
+    },
+    {
+      "name": "TopNavbar",
+      "type": "Module",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 1,
+      "end_line": 581,
+      "tags": {
+        "PURPOSE": "Auto-generated module for frontend/src/lib/components/layout/TopNavbar.svelte",
+        "COMPLEXITY": "1",
+        "LAYER": "Unknown"
+      },
+      "relations": [],
+      "children": [
+        {
+          "name": "toggleUserMenu",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 109,
+          "end_line": 109,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "closeUserMenu",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 114,
+          "end_line": 114,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleLogout",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 118,
+          "end_line": 118,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleActivityClick",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 124,
+          "end_line": 124,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleAssistantClick",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 135,
+          "end_line": 135,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "hydrateTaskDrawerPreference",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 133,
-          "end_line": 133,
+          "start_line": 139,
+          "end_line": 139,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71281,8 +72264,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 146,
-          "end_line": 146,
+          "start_line": 152,
+          "end_line": 152,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71300,25 +72283,6 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 151,
-          "end_line": 151,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleDocumentClick",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
           "start_line": 157,
           "end_line": 157,
           "tags": {
@@ -71333,13 +72297,32 @@
             "score": 1.0
           }
         },
+        {
+          "name": "handleDocumentClick",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 163,
+          "end_line": 163,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "handleHamburgerClick",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 167,
-          "end_line": 167,
+          "start_line": 173,
+          "end_line": 173,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71357,8 +72340,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 172,
-          "end_line": 172,
+          "start_line": 178,
+          "end_line": 178,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71376,8 +72359,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 179,
-          "end_line": 179,
+          "start_line": 185,
+          "end_line": 185,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71395,8 +72378,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 263,
-          "end_line": 263,
+          "start_line": 269,
+          "end_line": 269,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71414,8 +72397,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 315,
-          "end_line": 315,
+          "start_line": 321,
+          "end_line": 321,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71433,8 +72416,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 325,
-          "end_line": 325,
+          "start_line": 331,
+          "end_line": 331,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71452,8 +72435,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 338,
-          "end_line": 338,
+          "start_line": 344,
+          "end_line": 344,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71471,7 +72454,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 575 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 581 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -71485,13 +72468,13 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 187,
+      "end_line": 190,
       "tags": {
         "COMPLEXITY": "3",
         "PURPOSE": "Display page hierarchy navigation",
         "LAYER": "UI",
         "INVARIANT": "Always shows current page path",
-        "UX_STATE": "Idle -> Breadcrumbs showing current path",
+        "UX_STATE": "Collapsed -> Intermediate segments collapse into an ellipsis when the path exceeds the visibility budget.",
         "UX_FEEDBACK": "Hover on breadcrumb shows clickable state",
         "UX_RECOVERY": "Click breadcrumb to navigate",
         "PARAM": "{string} segment - URL segment",
@@ -71500,7 +72483,15 @@
       "relations": [
         {
           "type": "DEPENDS_ON",
-          "target": "page"
+          "target": "PageStore"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "i18n"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "Icon"
         }
       ],
       "children": [],
@@ -71513,27 +72504,27 @@
         {
           "store": "app",
           "type": "READS_FROM",
-          "line": 15
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 17
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
           "line": 18
         },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 20
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 21
+        },
         {
           "store": "props",
           "type": "WRITES_TO",
-          "line": 20
+          "line": 23
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 24
+          "line": 27
         }
       ]
     },
@@ -71543,7 +72534,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 187,
+      "end_line": 190,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/layout/Breadcrumbs.svelte",
         "COMPLEXITY": "1",
@@ -71556,8 +72547,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 33,
-          "end_line": 33,
+          "start_line": 36,
+          "end_line": 36,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71575,8 +72566,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 69,
-          "end_line": 69,
+          "start_line": 72,
+          "end_line": 72,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71594,8 +72585,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 89,
-          "end_line": 89,
+          "start_line": 92,
+          "end_line": 92,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -71621,17 +72612,18 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 854,
+      "end_line": 853,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "PURPOSE": "Global task drawer for monitoring background operations",
         "LAYER": "UI",
         "SEMANTICS": "TaskLogViewer",
+        "PRE": "Task drawer store and optional websocket task context are available before detail mode is requested.",
+        "POST": "Drawer stays closed, shows the recent-task list, or renders a selected task detail without losing task context.",
+        "SIDE_EFFECT": "Opens websocket streams, loads recent tasks, and mutates drawer selection state.",
+        "DATA_CONTRACT": "TaskDrawerState -> RecentTaskList | ActiveTaskDetail",
         "INVARIANT": "Drawer shows logs for active task or remains closed",
+        "UX_REACTIVITY": "Uses $state for local drawer UI and $derived or store subscriptions for active task synchronization.",
         "UX_STATE": "InputRequired -> Interactive form rendered in drawer",
         "UX_FEEDBACK": "Back button returns to task list",
         "UX_RECOVERY": "Back button shows task list when viewing task details",
@@ -71653,8 +72645,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 436,
-          "end_line": 452,
+          "start_line": 435,
+          "end_line": 451,
           "tags": {
             "UX_STATE": "Loading -> Default",
             "PURPOSE": "Disconnects the active WebSocket connection",
@@ -71675,12 +72667,12 @@
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 436
+                "line_number": 435
               },
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 436
+                "line_number": 435
               }
             ],
             "score": 0.5499999999999999
@@ -71691,8 +72683,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 454,
-          "end_line": 477,
+          "start_line": 453,
+          "end_line": 476,
           "tags": {
             "PURPOSE": "Load recent tasks for list mode display",
             "PRE": "User is on task drawer or api is ready.",
@@ -71711,8 +72703,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 479,
-          "end_line": 492,
+          "start_line": 478,
+          "end_line": 491,
           "tags": {
             "PURPOSE": "Select a task from list to view details",
             "PRE": "task is a valid task object",
@@ -71731,8 +72723,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 494,
-          "end_line": 513,
+          "start_line": 493,
+          "end_line": 512,
           "tags": {
             "UX_STATE": "Loading -> Default",
             "PURPOSE": "Return to task list view from task details",
@@ -71753,12 +72745,12 @@
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 494
+                "line_number": 493
               },
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 494
+                "line_number": 493
               }
             ],
             "score": 0.5499999999999999
@@ -71771,6 +72763,11 @@
         "score": 0.9
       },
       "data_flow": [
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 45
+        },
         {
           "store": "lib",
           "type": "READS_FROM",
@@ -71779,7 +72776,7 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 47
+          "line": 50
         },
         {
           "store": "lib",
@@ -71797,9 +72794,9 @@
           "line": 53
         },
         {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 54
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 57
         },
         {
           "store": "state",
@@ -71824,7 +72821,7 @@
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 62
+          "line": 64
         },
         {
           "store": "state",
@@ -71837,9 +72834,9 @@
           "line": 66
         },
         {
-          "store": "state",
+          "store": "derived",
           "type": "WRITES_TO",
-          "line": 67
+          "line": 71
         },
         {
           "store": "derived",
@@ -71859,87 +72856,87 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 75
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 80
+          "line": 79
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 180
+          "line": 179
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 267
+          "line": 266
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 267
+          "line": 266
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 267
+          "line": 266
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 267
+          "line": 266
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 279
+          "line": 278
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 290
+          "line": 289
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 290
+          "line": 289
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 290
+          "line": 289
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 304
+          "line": 303
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 331
+          "line": 330
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 342
+          "line": 341
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 353
+          "line": 352
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 385
+          "line": 384
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 516
+          "line": 515
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 539
         },
         {
           "store": "derived",
@@ -71947,124 +72944,119 @@
           "line": 540
         },
         {
-          "store": "derived",
+          "store": "t",
           "type": "WRITES_TO",
-          "line": 541
+          "line": 559
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 560
+          "line": 576
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 582
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 582
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 616
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 577
+          "line": 621
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 583
+          "line": 641
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 583
+          "line": 665
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 617
+          "line": 683
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 686
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 694
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 701
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 710
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 714
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 721
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 741
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 747
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 777
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 794
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 622
+          "line": 802
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 642
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 666
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 684
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 687
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 695
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 702
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 711
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 715
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 722
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 742
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 748
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 778
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 795
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
           "line": 803
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 804
+          "line": 838
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 839
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 850
+          "line": 849
         }
       ]
     },
@@ -72074,7 +73066,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 855,
+      "end_line": 854,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/lib/components/layout/TaskDrawer.svelte",
         "COMPLEXITY": "1",
@@ -72087,8 +73079,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 91,
-          "end_line": 91,
+          "start_line": 90,
+          "end_line": 90,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72106,8 +73098,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 96,
-          "end_line": 96,
+          "start_line": 95,
+          "end_line": 95,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72125,8 +73117,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 101,
-          "end_line": 101,
+          "start_line": 100,
+          "end_line": 100,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72144,8 +73136,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 108,
-          "end_line": 108,
+          "start_line": 107,
+          "end_line": 107,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72163,8 +73155,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 119,
-          "end_line": 119,
+          "start_line": 118,
+          "end_line": 118,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72182,8 +73174,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 128,
-          "end_line": 128,
+          "start_line": 127,
+          "end_line": 127,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72201,8 +73193,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 137,
-          "end_line": 137,
+          "start_line": 136,
+          "end_line": 136,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72220,8 +73212,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 147,
-          "end_line": 147,
+          "start_line": 146,
+          "end_line": 146,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72239,8 +73231,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 160,
-          "end_line": 160,
+          "start_line": 159,
+          "end_line": 159,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72258,8 +73250,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 167,
-          "end_line": 167,
+          "start_line": 166,
+          "end_line": 166,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72277,8 +73269,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 177,
-          "end_line": 177,
+          "start_line": 176,
+          "end_line": 176,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72296,8 +73288,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 183,
-          "end_line": 183,
+          "start_line": 182,
+          "end_line": 182,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72315,8 +73307,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 193,
-          "end_line": 193,
+          "start_line": 192,
+          "end_line": 192,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72334,8 +73326,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 202,
-          "end_line": 202,
+          "start_line": 201,
+          "end_line": 201,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72353,8 +73345,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 210,
-          "end_line": 210,
+          "start_line": 209,
+          "end_line": 209,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72372,8 +73364,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 225,
-          "end_line": 225,
+          "start_line": 224,
+          "end_line": 224,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72391,8 +73383,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 244,
-          "end_line": 244,
+          "start_line": 243,
+          "end_line": 243,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72410,8 +73402,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 328,
-          "end_line": 328,
+          "start_line": 327,
+          "end_line": 327,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72429,8 +73421,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 350,
-          "end_line": 350,
+          "start_line": 349,
+          "end_line": 349,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72448,8 +73440,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 381,
-          "end_line": 381,
+          "start_line": 380,
+          "end_line": 380,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72467,8 +73459,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 398,
-          "end_line": 398,
+          "start_line": 397,
+          "end_line": 397,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72486,7 +73478,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 855 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 854 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -72699,7 +73691,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 27,
+      "end_line": 31,
       "tags": {
         "COMPLEXITY": "3",
         "PURPOSE": "Global error page displaying HTTP status and messages",
@@ -72710,6 +73702,22 @@
         {
           "type": "USES",
           "target": "App"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
         }
       ],
       "children": [],
@@ -72751,12 +73759,8 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 102,
+      "end_line": 101,
       "tags": {
-        "SIDE_EFFECT": "None",
-        "PRE": "Default pre condition",
-        "POST": "Default post condition",
-        "DATA_CONTRACT": "Default state data",
         "COMPLEXITY": "5",
         "PURPOSE": "Redirect to preferred start page from profile settings with safe dashboards fallback.",
         "LAYER": "UI",
@@ -72771,6 +73775,18 @@
         {
           "type": "USES",
           "target": "App"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
         }
       ],
       "children": [],
@@ -72792,7 +73808,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 102,
+      "end_line": 101,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/+page.svelte",
         "COMPLEXITY": "1",
@@ -72805,8 +73821,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 36,
-          "end_line": 36,
+          "start_line": 35,
+          "end_line": 35,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72824,8 +73840,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 43,
-          "end_line": 43,
+          "start_line": 42,
+          "end_line": 42,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72843,8 +73859,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 49,
-          "end_line": 49,
+          "start_line": 48,
+          "end_line": 48,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -72891,7 +73907,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": null,
+      "end_line": 104,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "layout, root, navigation, sidebar, toast",
@@ -72900,6 +73916,10 @@
         "INVARIANT": "All pages except /login are wrapped in ProtectedRoute."
       },
       "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "NavigationContracts"
+        },
         {
           "type": "DEPENDS_ON",
           "target": "Sidebar"
@@ -72931,8 +73951,8 @@
           "type": "Module",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 16,
-          "end_line": 102,
+          "start_line": 17,
+          "end_line": 103,
           "tags": {
             "UX_STATE": "Loading -> Default",
             "COMPLEXITY": "3",
@@ -72956,15 +73976,9 @@
         }
       ],
       "compliance": {
-        "valid": false,
-        "issues": [
-          {
-            "message": "Unclosed Anchor: [DEF:RootLayout:Module] started at line 1",
-            "severity": "ERROR",
-            "line_number": 1
-          }
-        ],
-        "score": 0.0
+        "valid": true,
+        "issues": [],
+        "score": 0.925
       }
     },
     {
@@ -72973,12 +73987,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 965,
+      "end_line": 959,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "PURPOSE": "Dataset Hub - Dedicated hub for datasets with mapping progress",
         "LAYER": "UI",
@@ -73014,7 +74024,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 965,
+      "end_line": 959,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/datasets/+page.svelte",
         "COMPLEXITY": "1",
@@ -73027,8 +74037,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 116,
-          "end_line": 116,
+          "start_line": 110,
+          "end_line": 110,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73046,8 +74056,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 172,
-          "end_line": 172,
+          "start_line": 166,
+          "end_line": 166,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73065,6 +74075,25 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
+          "start_line": 171,
+          "end_line": 171,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handlePageSizeChange",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
           "start_line": 177,
           "end_line": 177,
           "tags": {
@@ -73079,32 +74108,13 @@
             "score": 1.0
           }
         },
-        {
-          "name": "handlePageSizeChange",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 183,
-          "end_line": 183,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
         {
           "name": "updateSelectionState",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 190,
-          "end_line": 190,
+          "start_line": 184,
+          "end_line": 184,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73122,8 +74132,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 200,
-          "end_line": 200,
+          "start_line": 194,
+          "end_line": 194,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73141,8 +74151,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 211,
-          "end_line": 211,
+          "start_line": 205,
+          "end_line": 205,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73160,8 +74170,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 235,
-          "end_line": 235,
+          "start_line": 229,
+          "end_line": 229,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73179,8 +74189,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 246,
-          "end_line": 246,
+          "start_line": 240,
+          "end_line": 240,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73198,8 +74208,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 266,
-          "end_line": 266,
+          "start_line": 260,
+          "end_line": 260,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73217,8 +74227,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 331,
-          "end_line": 331,
+          "start_line": 325,
+          "end_line": 325,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73236,8 +74246,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 365,
-          "end_line": 365,
+          "start_line": 359,
+          "end_line": 359,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73255,8 +74265,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 375,
-          "end_line": 375,
+          "start_line": 369,
+          "end_line": 369,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73274,8 +74284,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 392,
-          "end_line": 392,
+          "start_line": 386,
+          "end_line": 386,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73293,7 +74303,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 965 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 959 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -73307,7 +74317,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 544,
+      "end_line": 560,
       "tags": {
         "COMPLEXITY": "3 -->",
         "SEMANTICS": "dataset-review, workspace-entry, source-intake, session-bootstrap -->",
@@ -73347,7 +74357,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 544,
+      "end_line": 560,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/datasets/review/+page.svelte",
         "COMPLEXITY": "1",
@@ -73360,8 +74370,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 58,
-          "end_line": 58,
+          "start_line": 59,
+          "end_line": 59,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73379,8 +74389,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 62,
-          "end_line": 62,
+          "start_line": 63,
+          "end_line": 63,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73398,8 +74408,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 75,
-          "end_line": 75,
+          "start_line": 76,
+          "end_line": 76,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73417,8 +74427,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 80,
-          "end_line": 80,
+          "start_line": 81,
+          "end_line": 81,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73436,8 +74446,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 107,
-          "end_line": 107,
+          "start_line": 108,
+          "end_line": 108,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73455,8 +74465,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 121,
-          "end_line": 121,
+          "start_line": 137,
+          "end_line": 137,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73474,8 +74484,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 128,
-          "end_line": 128,
+          "start_line": 144,
+          "end_line": 144,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73493,8 +74503,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 133,
-          "end_line": 133,
+          "start_line": 149,
+          "end_line": 149,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73512,8 +74522,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 138,
-          "end_line": 138,
+          "start_line": 154,
+          "end_line": 154,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73531,25 +74541,6 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 151,
-          "end_line": 151,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "bootstrap",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
           "start_line": 167,
           "end_line": 167,
           "tags": {
@@ -73564,13 +74555,32 @@
             "score": 1.0
           }
         },
+        {
+          "name": "bootstrap",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 183,
+          "end_line": 183,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "handleSourceSubmit",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 177,
-          "end_line": 177,
+          "start_line": 193,
+          "end_line": 193,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -73588,7 +74598,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 544 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 560 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -73710,21 +74720,21 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 1261,
+      "end_line": 1200,
       "tags": {
         "COMPLEXITY": "5 -->",
-        "SEMANTICS": "dataset-review, workspace, session-resume, intake, findings, exports -->",
-        "PURPOSE": "Main dataset review workspace coordinating session state, progressive recovery, semantic review, clarification, preview, and launch UX. -->",
+        "SEMANTICS": "dataset-review, workspace, session-resume, chat-centric, preview, launch -->",
+        "PURPOSE": "Main dataset review workspace coordinating session state through a three-column chat-centric layout where the assistant is the primary review surface. -->",
         "LAYER": "UI -->",
         "PRE": "Review route has either a resumable session id or receives new intake input from the workspace form. -->",
-        "POST": "Session detail is loaded or created, highest-value next action is visible, and partial recovery remains readable and usable. -->",
+        "POST": "Session detail is loaded or created, assistant chat is centered, and preview plus launch blockers remain visible in the execution rail. -->",
         "SIDE_EFFECT": "Reads and mutates ownership-scoped review session state through dataset orchestration APIs and may navigate to a newly created session route. -->",
         "DATA_CONTRACT": "Input[route:id|StartSessionRequest] -> Output[SessionDetail|null] -->",
         "INVARIANT": "Navigation away from dirty session state must require explicit confirmation. -->",
-        "UX_STATE": "Ready -> Preview, warnings, and next-step evidence stay visible without hiding US2 review controls. -->",
-        "UX_FEEDBACK": "Main CTA changes by readiness state and reflects current highest-value next action. -->",
+        "UX_STATE": "Ready -> Preview, blockers, and launch action remain visible without displacing assistant guidance. -->",
+        "UX_FEEDBACK": "Main CTA and assistant prompts reflect current highest-value next action. -->",
         "UX_RECOVERY": "Users can save, resume, or reopen an unfinished session without losing context. -->",
-        "UX_REACTIVITY": "Uses Svelte runes for session, readiness, preview, and task state derivation. -->"
+        "UX_REACTIVITY": "Uses Svelte runes for session, readiness, preview, and action derivation. -->"
       },
       "relations": [
         {
@@ -73733,11 +74743,15 @@
         },
         {
           "type": "BINDS_TO",
-          "target": "assistantChat"
+          "target": "AssistantChatPanel"
         },
         {
           "type": "BINDS_TO",
-          "target": "taskDrawer"
+          "target": "CompiledSQLPreview"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "LaunchConfirmationPanel"
         }
       ],
       "children": [],
@@ -73750,20 +74764,10 @@
         {
           "store": "app",
           "type": "READS_FROM",
-          "line": 23
-        },
-        {
-          "store": "app",
-          "type": "READS_FROM",
-          "line": 24
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
           "line": 25
         },
         {
-          "store": "lib",
+          "store": "app",
           "type": "READS_FROM",
           "line": 26
         },
@@ -73805,112 +74809,92 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 39
+          "line": 34
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 43
+          "line": 35
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 48
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 42
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
+          "store": "lib",
+          "type": "READS_FROM",
           "line": 49
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 50
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 51
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 52
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
+          "store": "lib",
+          "type": "READS_FROM",
           "line": 53
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 54
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 55
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 56
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 57
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 58
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
+          "store": "lib",
+          "type": "READS_FROM",
           "line": 59
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 60
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 61
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 62
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 64
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 65
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
           "line": 66
         },
         {
-          "store": "derived",
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 67
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 68
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 69
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 70
+        },
+        {
+          "store": "state",
           "type": "WRITES_TO",
           "line": 71
         },
         {
-          "store": "derived",
+          "store": "state",
           "type": "WRITES_TO",
-          "line": 78
+          "line": 72
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 73
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 74
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 75
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 76
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 77
         },
         {
           "store": "derived",
@@ -73935,12 +74919,12 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 85
+          "line": 87
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 86
+          "line": 88
         },
         {
           "store": "derived",
@@ -73955,7 +74939,7 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 91
+          "line": 93
         },
         {
           "store": "derived",
@@ -73967,6 +74951,16 @@
           "type": "WRITES_TO",
           "line": 97
         },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 98
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 99
+        },
         {
           "store": "derived",
           "type": "WRITES_TO",
@@ -73975,7 +74969,7 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 103
+          "line": 101
         },
         {
           "store": "derived",
@@ -73985,12 +74979,12 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 105
+          "line": 107
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 106
+          "line": 108
         },
         {
           "store": "derived",
@@ -74000,17 +74994,17 @@
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 112
+          "line": 110
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 115
+          "line": 111
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 116
+          "line": 114
         },
         {
           "store": "derived",
@@ -74018,54 +75012,49 @@
           "line": 117
         },
         {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 118
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
+          "store": "derived",
+          "type": "WRITES_TO",
           "line": 120
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 122
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 123
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 127
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
           "line": 128
         },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 132
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 133
-        },
         {
           "store": "derived",
           "type": "WRITES_TO",
           "line": 134
         },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 135
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 137
+        },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 142
+          "line": 139
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 140
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 144
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 145
         },
         {
           "store": "derived",
@@ -74073,59 +75062,99 @@
           "line": 149
         },
         {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 158
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 150
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 151
+        },
+        {
+          "store": "derived",
+          "type": "WRITES_TO",
+          "line": 152
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 162
+          "line": 155
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 167
+          "line": 160
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 180
+          "line": 165
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 185
+          "line": 168
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 190
+          "line": 171
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 195
+          "line": 174
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 200
+          "line": 176
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 214
+          "line": 189
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 222
+          "line": 194
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 230
+          "line": 199
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 204
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 209
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 223
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 228
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 233
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 238
         },
         {
           "store": "t",
@@ -74140,27 +75169,32 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 304
+          "line": 264
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 305
+          "line": 264
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 342
+          "line": 264
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 343
+          "line": 267
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 352
+          "line": 267
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 267
         },
         {
           "store": "t",
@@ -74170,217 +75204,212 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 376
+          "line": 354
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 377
+          "line": 390
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 396
+          "line": 391
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 397
+          "line": 400
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 417
+          "line": 401
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 418
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 441
+          "line": 427
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 592
+          "line": 428
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 595
+          "line": 450
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 598
+          "line": 451
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 601
+          "line": 471
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 604
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 606
+          "line": 472
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 609
+          "line": 637
         },
         {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 627
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 630
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 633
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 640
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 647
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 651
-        },
-        {
-          "store": "t",
+          "store": "effect",
           "type": "READS_FROM",
           "line": 659
         },
         {
-          "store": "t",
+          "store": "effect",
           "type": "READS_FROM",
           "line": 667
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 712
+          "line": 682
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 735
+          "line": 685
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 738
+          "line": 688
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 741
+          "line": 695
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 784
+          "line": 702
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 789
+          "line": 706
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 803
+          "line": 714
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 847
+          "line": 737
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 854
+          "line": 740
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 860
+          "line": 743
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 882
+          "line": 780
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 895
+          "line": 786
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 906
+          "line": 792
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 915
+          "line": 800
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 924
+          "line": 814
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 935
+          "line": 819
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 943
+          "line": 830
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 947
+          "line": 859
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 964
+          "line": 869
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 971
+          "line": 872
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 976
+          "line": 875
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 883
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 898
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 918
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 940
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 960
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 974
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 980
         },
         {
           "store": "t",
@@ -74390,107 +75419,67 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 991
+          "line": 1068
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 995
+          "line": 1074
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1007
+          "line": 1080
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1016
+          "line": 1093
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1027
+          "line": 1098
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1031
+          "line": 1104
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1046
+          "line": 1110
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1112
+          "line": 1119
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1118
+          "line": 1122
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1131
+          "line": 1132
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 1151
+          "line": 1140
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 1148
         },
         {
           "store": "t",
           "type": "READS_FROM",
           "line": 1156
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1162
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1168
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1174
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1186
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1189
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1199
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1207
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1215
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 1223
         }
       ]
     },
@@ -74500,7 +75489,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 1261,
+      "end_line": 1200,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/datasets/review/[id]/+page.svelte",
         "COMPLEXITY": "1",
@@ -74508,51 +75497,13 @@
       },
       "relations": [],
       "children": [
-        {
-          "name": "normalizeJumpTarget",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 151,
-          "end_line": 151,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
         {
           "name": "getWorkspaceStateLabel",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 157,
-          "end_line": 157,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "getFallbackLabel",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 161,
-          "end_line": 161,
+          "start_line": 154,
+          "end_line": 154,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -74570,426 +75521,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 165,
-          "end_line": 165,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "buildImportMilestones",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 170,
-          "end_line": 170,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "buildRecentActions",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 206,
-          "end_line": 206,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "buildWorkspaceLaunchBlockers",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 254,
-          "end_line": 254,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "buildSessionUrl",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 275,
-          "end_line": 275,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "loadSessionDetail",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 279,
-          "end_line": 279,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "loadClarificationState",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 312,
-          "end_line": 312,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "bootstrapWorkspace",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 327,
-          "end_line": 327,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleSourceSubmit",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 334,
-          "end_line": 334,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleResumeSession",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 360,
-          "end_line": 360,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "updateSessionLifecycle",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 381,
-          "end_line": 381,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "exportArtifact",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 401,
-          "end_line": 401,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleFindingJump",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 424,
-          "end_line": 424,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "startSummaryEdit",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 428,
-          "end_line": 428,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "cancelSummaryEdit",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 434,
-          "end_line": 434,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "saveSummaryDraft",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 440,
-          "end_line": 440,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleSemanticUpdated",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 445,
-          "end_line": 445,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleClarificationUpdated",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 473,
-          "end_line": 473,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleExecutionMappingUpdated",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 492,
-          "end_line": 492,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handlePreviewUpdated",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 521,
-          "end_line": 521,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleLaunchUpdated",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 548,
-          "end_line": 548,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "handleSectionJump",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 556,
-          "end_line": 556,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "primaryActionHandler",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 560,
-          "end_line": 560,
+          "start_line": 158,
+          "end_line": 158,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75007,8 +75540,445 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 590,
-          "end_line": 590,
+          "start_line": 163,
+          "end_line": 163,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "buildImportMilestones",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 179,
+          "end_line": 179,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "buildWorkspaceLaunchBlockers",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 215,
+          "end_line": 215,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "stringifyValue",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 244,
+          "end_line": 244,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "buildAssistantContextPrompt",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 258,
+          "end_line": 258,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "mergeCollectionItem",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 270,
+          "end_line": 270,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "applySessionVersion",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 283,
+          "end_line": 283,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "buildAssistantSeedPrompt",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 294,
+          "end_line": 294,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "promptAssistantAbout",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 319,
+          "end_line": 319,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "buildSessionUrl",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 325,
+          "end_line": 325,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "loadSessionDetail",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 329,
+          "end_line": 329,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "loadClarificationState",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 361,
+          "end_line": 361,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "bootstrapWorkspace",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 376,
+          "end_line": 376,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleSourceSubmit",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 383,
+          "end_line": 383,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleResumeSession",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 408,
+          "end_line": 408,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "updateSessionLifecycle",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 432,
+          "end_line": 432,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "exportArtifact",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 455,
+          "end_line": 455,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handlePreviewUpdated",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 478,
+          "end_line": 478,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleSemanticUpdated",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 508,
+          "end_line": 508,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleMappingUpdated",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 532,
+          "end_line": 532,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleLaunchUpdated",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 562,
+          "end_line": 562,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleSectionJump",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 569,
+          "end_line": 569,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "handleAskAiContext",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 593,
+          "end_line": 593,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "primaryActionHandler",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 605,
+          "end_line": 605,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75026,7 +75996,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 1261 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 1200 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -75040,17 +76010,13 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 5,
-      "end_line": 731,
+      "end_line": null,
       "tags": {
         "COMPLEXITY": "3",
-        "SEMANTICS": "dataset-review, workspace, route, ux-tests, review-state, exports, recovery",
-        "PURPOSE": "Verify US1-safe and US2-integrated dataset review workspace flow evidence for empty, load, import, semantics, clarification, and export behaviors.",
+        "SEMANTICS": "dataset-review, workspace, route, ux-tests, review-state, chat-centric, execution-rail",
+        "PURPOSE": "Verify the `027` dataset review workspace keeps assistant chat as the primary surface while preserving execution rail and resumable intake behavior.",
         "LAYER": "UI",
-        "UX_STATE": "Review -> Workspace exposes summary controls, mounted semantic review, clarification dialog, findings, and export affordances.",
-        "TEST_CONTRACT": "DatasetReviewWorkspaceDependencies -> ObservableWorkspaceUX",
-        "TEST_SCENARIO": "export_feedback_surfaces_success_and_error -> Export action exposes both artifact success detail and failure feedback.",
-        "TEST_EDGE": "external_fail -> API failures surface explicit feedback without collapsing the workspace.",
-        "TEST_INVARIANT": "us1_workspace_remains_readable_and_actionable -> VERIFIED_BY: [empty_state_renders_source_intake, session_load_surfaces_partial_recovery_state, import_submission_transitions_to_review_state, export_feedback_surfaces_success_and_error]"
+        "UX_STATE": "Review -> Workspace exposes left context rail, embedded assistant center, and right execution rail."
       },
       "relations": [
         {
@@ -75064,8 +76030,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 34,
-          "end_line": 34,
+          "start_line": 24,
+          "end_line": 24,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75083,8 +76049,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 134,
-          "end_line": 134,
+          "start_line": 114,
+          "end_line": 114,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75099,20 +76065,20 @@
         }
       ],
       "compliance": {
-        "valid": true,
+        "valid": false,
         "issues": [
+          {
+            "message": "Unclosed Anchor: [DEF:DatasetReviewWorkspaceUxTests:Module] started at line 5",
+            "severity": "ERROR",
+            "line_number": 5
+          },
           {
             "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
             "severity": "WARNING",
             "line_number": 5
-          },
-          {
-            "message": "Fractal limit warning: Module length is 727 lines (must be < 300)",
-            "severity": "WARNING",
-            "line_number": 5
           }
         ],
-        "score": 0.625
+        "score": 0.0
       }
     },
     {
@@ -75121,12 +76087,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 408,
+      "end_line": 402,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "PURPOSE": "Dataset Detail View - Shows detailed dataset information with columns, SQL, and linked dashboards",
         "LAYER": "UI",
@@ -75158,7 +76120,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 408,
+      "end_line": 402,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/datasets/[id]/+page.svelte",
         "COMPLEXITY": "1",
@@ -75171,8 +76133,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 58,
-          "end_line": 58,
+          "start_line": 52,
+          "end_line": 52,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75190,8 +76152,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 79,
-          "end_line": 79,
+          "start_line": 73,
+          "end_line": 73,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75209,8 +76171,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 86,
-          "end_line": 86,
+          "start_line": 80,
+          "end_line": 80,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75228,8 +76190,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 91,
-          "end_line": 91,
+          "start_line": 85,
+          "end_line": 85,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75247,8 +76209,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 115,
-          "end_line": 115,
+          "start_line": 109,
+          "end_line": 109,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75266,7 +76228,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 408 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 402 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -75280,12 +76242,8 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 229,
+      "end_line": 223,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "SEMANTICS": "reports, unified, filters, loading, empty, error",
         "PURPOSE": "Unified reports page with filtering and resilient UX states for mixed task types.",
@@ -75317,85 +76275,100 @@
             "message": "Missing Mandatory Tag: @UX_REACTIVITY (required for complexity 5)",
             "severity": "ERROR",
             "line_number": 1
+          },
+          {
+            "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
+            "severity": "ERROR",
+            "line_number": 1
+          },
+          {
+            "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
+            "severity": "ERROR",
+            "line_number": 1
           }
         ],
-        "score": 0.43333333333333335
+        "score": 0.0
       },
       "data_flow": [
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 43
+          "line": 37
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 44
+          "line": 38
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 45
+          "line": 39
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 46
+          "line": 40
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 47
+          "line": 41
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 61
+          "line": 55
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 57
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 58
         },
         {
           "store": "t",
           "type": "READS_FROM",
           "line": 63
         },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 64
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 69
-        },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 136
+          "line": 130
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 167
+          "line": 161
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 174
+          "line": 168
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 183
+          "line": 177
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 194
+          "line": 188
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 194
+          "line": 188
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 195
         },
         {
           "store": "t",
@@ -75405,12 +76378,7 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 207
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 212
+          "line": 206
         }
       ]
     },
@@ -75420,7 +76388,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 229,
+      "end_line": 223,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/reports/+page.svelte",
         "COMPLEXITY": "1",
@@ -75433,8 +76401,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 76,
-          "end_line": 76,
+          "start_line": 70,
+          "end_line": 70,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75452,8 +76420,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 87,
-          "end_line": 87,
+          "start_line": 81,
+          "end_line": 81,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75471,8 +76439,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 104,
-          "end_line": 104,
+          "start_line": 98,
+          "end_line": 98,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75490,8 +76458,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 108,
-          "end_line": 108,
+          "start_line": 102,
+          "end_line": 102,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75509,8 +76477,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 117,
-          "end_line": 117,
+          "start_line": 111,
+          "end_line": 111,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75528,8 +76496,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 124,
-          "end_line": 124,
+          "start_line": 118,
+          "end_line": 118,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -75772,7 +76740,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": null,
+      "end_line": 33,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "llm-report, svelte-effect, screenshot-loading, regression-test",
@@ -75825,20 +76793,15 @@
         }
       ],
       "compliance": {
-        "valid": false,
+        "valid": true,
         "issues": [
-          {
-            "message": "Unclosed Anchor: [DEF:ReportPageContractTest:Module] started at line 1",
-            "severity": "ERROR",
-            "line_number": 1
-          },
           {
             "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
             "severity": "WARNING",
             "line_number": 1
           }
         ],
-        "score": 0.0
+        "score": 0.775
       }
     },
     {
@@ -75993,17 +76956,31 @@
     {
       "name": "StorageIndexPage",
       "type": "Page",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 16,
+      "end_line": 20,
       "tags": {
-        "COMPLEXITY": "1",
+        "COMPLEXITY": "3",
         "PURPOSE": "Redirect to the backups page as the default storage view.",
         "LAYER": "Page",
+        "UX_STATE": "Redirecting -> Immediately transfers the user to /storage/backups.",
         "INVARIANT": "Always redirects to /storage/backups."
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        }
+      ],
       "children": [],
       "compliance": {
         "valid": true,
@@ -76136,12 +77113,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 2865,
+      "end_line": 2859,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "PURPOSE": "Dashboard Hub - Central hub for managing dashboards with Git status and task actions",
         "LAYER": "UI",
@@ -76171,8 +77144,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 180,
-          "end_line": 193,
+          "start_line": 174,
+          "end_line": 187,
           "tags": {
             "PURPOSE": "Normalize raw task status to stable lowercase token for UI.",
             "PRE": "status can be enum-like string or null.",
@@ -76191,8 +77164,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 195,
-          "end_line": 210,
+          "start_line": 189,
+          "end_line": 204,
           "tags": {
             "PURPOSE": "Normalize validation status to pass/fail/warn/unknown.",
             "PRE": "status can be any scalar.",
@@ -76211,8 +77184,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 212,
-          "end_line": 226,
+          "start_line": 206,
+          "end_line": 220,
           "tags": {
             "PURPOSE": "Map validation level to badge class tuple.",
             "PRE": "level in pass|fail|warn|unknown.",
@@ -76231,8 +77204,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 228,
-          "end_line": 241,
+          "start_line": 222,
+          "end_line": 235,
           "tags": {
             "PURPOSE": "Map normalized validation level to compact UI label.",
             "PRE": "level in pass|fail|warn|unknown.",
@@ -76251,8 +77224,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 243,
-          "end_line": 279,
+          "start_line": 237,
+          "end_line": 273,
           "tags": {
             "PURPOSE": "Normalize owners payload to unique non-empty display labels.",
             "PRE": "owners can be null, list of strings, or list of user objects.",
@@ -76271,8 +77244,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 281,
-          "end_line": 483,
+          "start_line": 275,
+          "end_line": 477,
           "tags": {
             "PURPOSE": "Load full dashboard dataset for current environment and hydrate grid projection.",
             "PRE": "selectedEnv is not null.",
@@ -76286,8 +77259,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 403,
-              "end_line": 415,
+              "start_line": 397,
+              "end_line": 409,
               "tags": {
                 "PURPOSE": "Temporarily disable profile-default dashboard filter for current page context.",
                 "PRE": "Dashboards list is loaded in dashboards_main context.",
@@ -76306,8 +77279,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 417,
-              "end_line": 429,
+              "start_line": 411,
+              "end_line": 423,
               "tags": {
                 "PURPOSE": "Re-enable persisted profile-default filtering after temporary override.",
                 "PRE": "Current page is in override mode.",
@@ -76333,8 +77306,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 485,
-          "end_line": 498,
+          "start_line": 479,
+          "end_line": 492,
           "tags": {
             "PURPOSE": "Convert ISO timestamp to locale date string.",
             "PRE": "value may be null or invalid date string.",
@@ -76353,8 +77326,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 500,
-          "end_line": 518,
+          "start_line": 494,
+          "end_line": 512,
           "tags": {
             "PURPOSE": "Compute stable text label for git state column.",
             "PRE": "dashboard has git projection fields.",
@@ -76373,8 +77346,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 520,
-          "end_line": 532,
+          "start_line": 514,
+          "end_line": 526,
           "tags": {
             "PURPOSE": "Compute normalized LLM validation summary label.",
             "PRE": "dashboard may have null lastTask.",
@@ -76393,8 +77366,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 534,
-          "end_line": 551,
+          "start_line": 528,
+          "end_line": 545,
           "tags": {
             "PURPOSE": "Resolve comparable/filterable display value for any grid column.",
             "PRE": "column belongs to filterable column set.",
@@ -76413,8 +77386,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 553,
-          "end_line": 568,
+          "start_line": 547,
+          "end_line": 562,
           "tags": {
             "PURPOSE": "Build unique sorted value list for a column filter dropdown.",
             "PRE": "allDashboards is hydrated.",
@@ -76433,8 +77406,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 570,
-          "end_line": 583,
+          "start_line": 564,
+          "end_line": 577,
           "tags": {
             "PURPOSE": "Apply in-dropdown search over full filter options.",
             "PRE": "columnFilterSearch contains search token for column.",
@@ -76453,8 +77426,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 585,
-          "end_line": 614,
+          "start_line": 579,
+          "end_line": 608,
           "tags": {
             "PURPOSE": "Toggle active column filter popover.",
             "PRE": "column is valid filter key.",
@@ -76473,8 +77446,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 616,
-          "end_line": 634,
+          "start_line": 610,
+          "end_line": 628,
           "tags": {
             "PURPOSE": "Add/remove specific filter value and reapply projection.",
             "PRE": "value comes from option list of the same column.",
@@ -76493,8 +77466,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 636,
-          "end_line": 648,
+          "start_line": 630,
+          "end_line": 642,
           "tags": {
             "PURPOSE": "Reset selected values for one column.",
             "PRE": "column is valid filter key.",
@@ -76513,8 +77486,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 650,
-          "end_line": 665,
+          "start_line": 644,
+          "end_line": 659,
           "tags": {
             "PURPOSE": "Select all currently visible values in filter popover.",
             "PRE": "visible options computed for current search token.",
@@ -76533,8 +77506,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 667,
-          "end_line": 677,
+          "start_line": 661,
+          "end_line": 671,
           "tags": {
             "PURPOSE": "Update local search token for one filter popover.",
             "PRE": "value is text from input.",
@@ -76553,8 +77526,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 679,
-          "end_line": 689,
+          "start_line": 673,
+          "end_line": 683,
           "tags": {
             "PURPOSE": "Determine if column has active selected values.",
             "PRE": "column is valid filter key.",
@@ -76573,8 +77546,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 691,
-          "end_line": 708,
+          "start_line": 685,
+          "end_line": 702,
           "tags": {
             "PURPOSE": "Evaluate dashboard row against all active column filters.",
             "PRE": "dashboard contains projected values for each filterable column.",
@@ -76593,8 +77566,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 710,
-          "end_line": 728,
+          "start_line": 704,
+          "end_line": 722,
           "tags": {
             "PURPOSE": "Compute stable comparable sort key for chosen column.",
             "PRE": "column belongs to sortable set.",
@@ -76613,8 +77586,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 730,
-          "end_line": 747,
+          "start_line": 724,
+          "end_line": 741,
           "tags": {
             "PURPOSE": "Toggle or switch sort order and reapply grid projection.",
             "PRE": "column belongs to sortable set.",
@@ -76633,8 +77606,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 749,
-          "end_line": 760,
+          "start_line": 743,
+          "end_line": 754,
           "tags": {
             "PURPOSE": "Return visual indicator for active/inactive sort header.",
             "PRE": "column belongs to sortable set.",
@@ -76653,8 +77626,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 762,
-          "end_line": 789,
+          "start_line": 756,
+          "end_line": 783,
           "tags": {
             "PURPOSE": "Apply search + column filters + sort + pagination to grid data.",
             "PRE": "allDashboards is current source collection.",
@@ -76682,7 +77655,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 2865,
+      "end_line": 2859,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/dashboards/+page.svelte",
         "COMPLEXITY": "1",
@@ -76695,8 +77668,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 165,
-          "end_line": 165,
+          "start_line": 159,
+          "end_line": 159,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76714,8 +77687,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 186,
-          "end_line": 186,
+          "start_line": 180,
+          "end_line": 180,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76733,8 +77706,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 201,
-          "end_line": 201,
+          "start_line": 195,
+          "end_line": 195,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76752,8 +77725,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 218,
-          "end_line": 218,
+          "start_line": 212,
+          "end_line": 212,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76771,8 +77744,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 234,
-          "end_line": 234,
+          "start_line": 228,
+          "end_line": 228,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76790,8 +77763,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 249,
-          "end_line": 249,
+          "start_line": 243,
+          "end_line": 243,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76809,8 +77782,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 289,
-          "end_line": 289,
+          "start_line": 283,
+          "end_line": 283,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76828,8 +77801,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 385,
-          "end_line": 385,
+          "start_line": 379,
+          "end_line": 379,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76847,8 +77820,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 390,
-          "end_line": 390,
+          "start_line": 384,
+          "end_line": 384,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76866,8 +77839,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 397,
-          "end_line": 397,
+          "start_line": 391,
+          "end_line": 391,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76885,8 +77858,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 409,
-          "end_line": 409,
+          "start_line": 403,
+          "end_line": 403,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76904,8 +77877,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 423,
-          "end_line": 423,
+          "start_line": 417,
+          "end_line": 417,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76923,8 +77896,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 432,
-          "end_line": 432,
+          "start_line": 426,
+          "end_line": 426,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76942,8 +77915,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 441,
-          "end_line": 441,
+          "start_line": 435,
+          "end_line": 435,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76961,8 +77934,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 446,
-          "end_line": 446,
+          "start_line": 440,
+          "end_line": 440,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76980,8 +77953,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 451,
-          "end_line": 451,
+          "start_line": 445,
+          "end_line": 445,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -76999,8 +77972,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 462,
-          "end_line": 462,
+          "start_line": 456,
+          "end_line": 456,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77018,8 +77991,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 473,
-          "end_line": 473,
+          "start_line": 467,
+          "end_line": 467,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77037,8 +78010,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 491,
-          "end_line": 491,
+          "start_line": 485,
+          "end_line": 485,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77056,8 +78029,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 506,
-          "end_line": 506,
+          "start_line": 500,
+          "end_line": 500,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77075,8 +78048,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 526,
-          "end_line": 526,
+          "start_line": 520,
+          "end_line": 520,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77094,8 +78067,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 540,
-          "end_line": 540,
+          "start_line": 534,
+          "end_line": 534,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77113,8 +78086,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 559,
-          "end_line": 559,
+          "start_line": 553,
+          "end_line": 553,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77132,8 +78105,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 576,
-          "end_line": 576,
+          "start_line": 570,
+          "end_line": 570,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77151,8 +78124,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 591,
-          "end_line": 591,
+          "start_line": 585,
+          "end_line": 585,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77170,8 +78143,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 622,
-          "end_line": 622,
+          "start_line": 616,
+          "end_line": 616,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77189,8 +78162,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 642,
-          "end_line": 642,
+          "start_line": 636,
+          "end_line": 636,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77208,8 +78181,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 656,
-          "end_line": 656,
+          "start_line": 650,
+          "end_line": 650,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77227,8 +78200,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 673,
-          "end_line": 673,
+          "start_line": 667,
+          "end_line": 667,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77246,8 +78219,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 685,
-          "end_line": 685,
+          "start_line": 679,
+          "end_line": 679,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77265,8 +78238,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 697,
-          "end_line": 697,
+          "start_line": 691,
+          "end_line": 691,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77284,8 +78257,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 716,
-          "end_line": 716,
+          "start_line": 710,
+          "end_line": 710,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77303,8 +78276,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 736,
-          "end_line": 736,
+          "start_line": 730,
+          "end_line": 730,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77322,8 +78295,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 755,
-          "end_line": 755,
+          "start_line": 749,
+          "end_line": 749,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77341,8 +78314,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 769,
-          "end_line": 769,
+          "start_line": 763,
+          "end_line": 763,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77360,8 +78333,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 792,
-          "end_line": 792,
+          "start_line": 786,
+          "end_line": 786,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77379,8 +78352,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 799,
-          "end_line": 799,
+          "start_line": 793,
+          "end_line": 793,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77398,8 +78371,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 804,
-          "end_line": 804,
+          "start_line": 798,
+          "end_line": 798,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77417,8 +78390,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 844,
-          "end_line": 844,
+          "start_line": 838,
+          "end_line": 838,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77436,8 +78409,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 882,
-          "end_line": 882,
+          "start_line": 876,
+          "end_line": 876,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77455,8 +78428,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 895,
-          "end_line": 895,
+          "start_line": 889,
+          "end_line": 889,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77474,8 +78447,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 913,
-          "end_line": 913,
+          "start_line": 907,
+          "end_line": 907,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77493,8 +78466,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 920,
-          "end_line": 920,
+          "start_line": 914,
+          "end_line": 914,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77512,8 +78485,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 951,
-          "end_line": 951,
+          "start_line": 945,
+          "end_line": 945,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77531,8 +78504,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1002,
-          "end_line": 1002,
+          "start_line": 996,
+          "end_line": 996,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77550,8 +78523,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1048,
-          "end_line": 1048,
+          "start_line": 1042,
+          "end_line": 1042,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77569,8 +78542,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1084,
-          "end_line": 1084,
+          "start_line": 1078,
+          "end_line": 1078,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77588,8 +78561,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1093,
-          "end_line": 1093,
+          "start_line": 1087,
+          "end_line": 1087,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77607,8 +78580,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1102,
-          "end_line": 1102,
+          "start_line": 1096,
+          "end_line": 1096,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77626,8 +78599,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1114,
-          "end_line": 1114,
+          "start_line": 1108,
+          "end_line": 1108,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77645,8 +78618,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1118,
-          "end_line": 1118,
+          "start_line": 1112,
+          "end_line": 1112,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77664,6 +78637,25 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
+          "start_line": 1121,
+          "end_line": 1121,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "updateDashboardGitState",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
           "start_line": 1127,
           "end_line": 1127,
           "tags": {
@@ -77678,32 +78670,13 @@
             "score": 1.0
           }
         },
-        {
-          "name": "updateDashboardGitState",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 1133,
-          "end_line": 1133,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
         {
           "name": "normalizeRepositoryStatusPayload",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1146,
-          "end_line": 1146,
+          "start_line": 1140,
+          "end_line": 1140,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77721,8 +78694,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1183,
-          "end_line": 1183,
+          "start_line": 1177,
+          "end_line": 1177,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77740,8 +78713,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1239,
-          "end_line": 1239,
+          "start_line": 1233,
+          "end_line": 1233,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77759,8 +78732,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1243,
-          "end_line": 1243,
+          "start_line": 1237,
+          "end_line": 1237,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77778,8 +78751,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1256,
-          "end_line": 1256,
+          "start_line": 1250,
+          "end_line": 1250,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77797,8 +78770,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1292,
-          "end_line": 1292,
+          "start_line": 1286,
+          "end_line": 1286,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77816,8 +78789,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1305,
-          "end_line": 1305,
+          "start_line": 1299,
+          "end_line": 1299,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77835,8 +78808,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1333,
-          "end_line": 1333,
+          "start_line": 1327,
+          "end_line": 1327,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77854,8 +78827,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1347,
-          "end_line": 1347,
+          "start_line": 1341,
+          "end_line": 1341,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77873,8 +78846,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1362,
-          "end_line": 1362,
+          "start_line": 1356,
+          "end_line": 1356,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77892,8 +78865,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1383,
-          "end_line": 1383,
+          "start_line": 1377,
+          "end_line": 1377,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77911,8 +78884,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1466,
-          "end_line": 1466,
+          "start_line": 1460,
+          "end_line": 1460,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -77930,7 +78903,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 2865 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 2859 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -78316,21 +79289,29 @@
       "start_line": 1,
       "end_line": 1063,
       "tags": {
-        "SIDE_EFFECT": "None",
-        "UX_STATE": "Loading -> Default",
-        "PRE": "Default pre condition",
-        "POST": "Default post condition",
-        "DATA_CONTRACT": "Default state data",
         "COMPLEXITY": "5",
         "PURPOSE": "Dashboard Detail View - Overview of charts and datasets linked to a dashboard",
         "LAYER": "UI",
         "INVARIANT": "Shows dashboard metadata, charts, and datasets for selected environment",
+        "UX_STATE": "Error -> Inline recovery keeps the user on the current dashboard route.",
         "TEST_DATA": "llm_unconfigured -> {\"llmStatus\":{\"configured\":false,\"reason\":\"invalid_api_key\"}}",
         "TEST_CONTRACT": "Page_DashboardDetail ->",
         "TEST_FIXTURE": "init_state -> {\"id\": \"1\", \"env_id\": \"env1\"}",
         "TEST_INVARIANT": "dashboard_fetching -> verifies: [init_state]"
       },
       "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        },
         {
           "type": "DEPENDS_ON",
           "target": "api_module"
@@ -79136,17 +80117,27 @@
     {
       "name": "AdminUsersPage",
       "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 285,
+      "end_line": 292,
       "tags": {
+        "COMPLEXITY": "3",
         "SEMANTICS": "admin, user-management, rbac",
         "PURPOSE": "UI for managing system users and their roles.",
         "LAYER": "Feature",
+        "UX_STATE": "Error -> Inline admin error is shown without discarding current form state.",
         "INVARIANT": "Only accessible by users with \"admin:users\" permission."
       },
       "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
         {
           "type": "DEPENDS_ON",
           "target": "frontend.src.services.adminService"
@@ -79162,8 +80153,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 37,
-          "end_line": 59,
+          "start_line": 44,
+          "end_line": 66,
           "tags": {
             "PURPOSE": "Fetches users and roles from the backend.",
             "PRE": "Component mounted.",
@@ -79182,8 +80173,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 61,
-          "end_line": 72,
+          "start_line": 68,
+          "end_line": 79,
           "tags": {
             "PURPOSE": "Prepares the form for creating a new user.",
             "POST": "showModal is true, isEditing is false, userForm is reset."
@@ -79201,8 +80192,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 74,
-          "end_line": 93,
+          "start_line": 81,
+          "end_line": 100,
           "tags": {
             "PURPOSE": "Prepares the form for editing an existing user.",
             "PRE": "user object must be valid.",
@@ -79222,8 +80213,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 95,
-          "end_line": 122,
+          "start_line": 102,
+          "end_line": 129,
           "tags": {
             "PURPOSE": "Submits user data to the backend (create or update).",
             "PRE": "userForm must be valid.",
@@ -79244,8 +80235,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 124,
-          "end_line": 150,
+          "start_line": 131,
+          "end_line": 157,
           "tags": {
             "PURPOSE": "Deletes a user after confirmation.",
             "PRE": "user object must be valid.",
@@ -79266,133 +80257,123 @@
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 1.0
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 15
+          "line": 22
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 53
+          "line": 60
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 118
+          "line": 125
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 135
+          "line": 142
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 144
+          "line": 151
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 159
+          "line": 166
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 164
+          "line": 171
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 170
+          "line": 177
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 174
+          "line": 181
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 182
+          "line": 189
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 183
+          "line": 190
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 184
+          "line": 191
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 185
+          "line": 192
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 186
+          "line": 193
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 187
+          "line": 194
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 211
+          "line": 218
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 211
+          "line": 218
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 216
+          "line": 223
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 222
+          "line": 229
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 222
+          "line": 229
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 236
+          "line": 243
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 236
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
           "line": 243
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 247
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 251
+          "line": 250
         },
         {
           "store": "t",
@@ -79402,27 +80383,37 @@
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 260
+          "line": 258
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 264
+          "line": 261
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 270
+          "line": 267
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 273
+          "line": 271
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 274
+          "line": 277
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 280
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 281
         }
       ]
     },
@@ -79978,8 +80969,8 @@
       "type": "Component",
       "complexity": 1,
       "tier": "TRIVIAL",
-      "start_line": 41,
-      "end_line": 461,
+      "start_line": 36,
+      "end_line": 456,
       "tags": {
         "PURPOSE": "Orchestrate migration UI workflow and route user actions to backend APIs and task store.",
         "PRE": "API client and component dependencies are available; i18n store is initialized.",
@@ -79994,8 +80985,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 105,
-          "end_line": 125,
+          "start_line": 100,
+          "end_line": 120,
           "tags": {
             "PURPOSE": "Fetches the list of environments from the API.",
             "PRE": "None.",
@@ -80014,8 +81005,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 127,
-          "end_line": 148,
+          "start_line": 122,
+          "end_line": 143,
           "tags": {
             "PURPOSE": "Fetches dashboards for the selected source environment.",
             "PRE": "envId is a valid environment ID.",
@@ -80035,8 +81026,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 152,
-          "end_line": 164,
+          "start_line": 147,
+          "end_line": 159,
           "tags": {
             "PURPOSE": "Automatically fetch dashboards when the source environment is changed.",
             "PRE": "sourceEnvId is not empty.",
@@ -80056,8 +81047,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 166,
-          "end_line": 212,
+          "start_line": 161,
+          "end_line": 207,
           "tags": {
             "PURPOSE": "Fetches databases from both environments and gets suggestions.",
             "PRE": "sourceEnvId and targetEnvId must be set.",
@@ -80076,8 +81067,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 214,
-          "end_line": 253,
+          "start_line": 209,
+          "end_line": 248,
           "tags": {
             "PURPOSE": "Saves a mapping to the backend.",
             "PRE": "event.detail contains sourceUuid and targetUuid.",
@@ -80096,8 +81087,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 255,
-          "end_line": 267,
+          "start_line": 250,
+          "end_line": 262,
           "tags": {
             "PURPOSE": "Opens the log viewer for a specific task.",
             "PRE": "event.detail contains task object.",
@@ -80116,8 +81107,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 269,
-          "end_line": 303,
+          "start_line": 264,
+          "end_line": 298,
           "tags": {
             "PURPOSE": "Reactive logic to show password prompt when a task is awaiting input.",
             "PRE": "selectedTask status is AWAITING_INPUT.",
@@ -80130,8 +81121,8 @@
               "type": "Block",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 278,
-              "end_line": 302,
+              "start_line": 273,
+              "end_line": 297,
               "tags": {
                 "PURPOSE": "Monitor selected task for input requests and trigger password prompt.",
                 "PRE": "$selectedTask is not null and status is AWAITING_INPUT.",
@@ -80158,8 +81149,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 305,
-          "end_line": 326,
+          "start_line": 300,
+          "end_line": 321,
           "tags": {
             "PURPOSE": "Resumes a migration task with provided passwords.",
             "PRE": "event.detail contains passwords.",
@@ -80178,8 +81169,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 328,
-          "end_line": 403,
+          "start_line": 323,
+          "end_line": 398,
           "tags": {
             "PURPOSE": "Initiates the migration process by sending the selection to the backend.",
             "PRE": "sourceEnvId and targetEnvId are set and different; at least one dashboard is selected.",
@@ -80200,8 +81191,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 405,
-          "end_line": 460,
+          "start_line": 400,
+          "end_line": 455,
           "tags": {
             "PURPOSE": "Performs a dry-run migration to identify potential risks and changes.",
             "PRE": "source/target environments and selected dashboards are valid.",
@@ -80228,13 +81219,38 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 69
+          "line": 64
         },
         {
           "store": "lib",
           "type": "READS_FROM",
+          "line": 65
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 69
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
           "line": 70
         },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 71
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 72
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 73
+        },
         {
           "store": "state",
           "type": "WRITES_TO",
@@ -80290,16 +81306,6 @@
           "type": "WRITES_TO",
           "line": 84
         },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 85
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 86
-        },
         {
           "store": "state",
           "type": "WRITES_TO",
@@ -80315,6 +81321,11 @@
           "type": "WRITES_TO",
           "line": 89
         },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 91
+        },
         {
           "store": "state",
           "type": "WRITES_TO",
@@ -80326,89 +81337,74 @@
           "line": 93
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 94
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 96
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 97
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 98
+          "store": "effect",
+          "type": "READS_FROM",
+          "line": 154
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 159
-        },
-        {
-          "store": "effect",
-          "type": "READS_FROM",
-          "line": 285
+          "line": 280
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 321
+          "line": 316
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 341
+          "line": 336
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 348
+          "line": 343
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 355
+          "line": 350
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 419
+          "line": 414
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 426
+          "line": 421
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 433
+          "line": 428
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 477
+          "line": 472
         },
         {
           "store": "selectedTask",
           "type": "READS_FROM",
-          "line": 485
+          "line": 480
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 493
+          "line": 488
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 500
+          "line": 495
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 507
         },
         {
           "store": "t",
@@ -80417,48 +81413,43 @@
         },
         {
           "store": "t",
-          "type": "WRITES_TO",
-          "line": 517
+          "type": "READS_FROM",
+          "line": 522
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 527
+          "line": 533
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 538
+          "line": 550
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 555
+          "line": 567
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 572
+          "line": 576
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 581
+          "line": 580
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 585
+          "line": 596
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 601
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 627
+          "line": 622
         }
       ]
     },
@@ -80467,8 +81458,8 @@
       "type": "Block",
       "complexity": 1,
       "tier": "TRIVIAL",
-      "start_line": 464,
-      "end_line": 705,
+      "start_line": 459,
+      "end_line": 700,
       "tags": {
         "PURPOSE": "Render migration configuration controls, action CTAs, dry-run results, and modal entry points.",
         "UX_STATE": "Success -> Dry-run details or TaskRunner content is presented.",
@@ -80482,8 +81473,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 476,
-          "end_line": 478,
+          "start_line": 471,
+          "end_line": 473,
           "tags": {},
           "relations": [],
           "children": [],
@@ -80498,8 +81489,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 480,
-          "end_line": 482,
+          "start_line": 475,
+          "end_line": 477,
           "tags": {},
           "relations": [],
           "children": [],
@@ -80514,8 +81505,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 484,
-          "end_line": 498,
+          "start_line": 479,
+          "end_line": 493,
           "tags": {},
           "relations": [],
           "children": [],
@@ -80530,8 +81521,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 509,
-          "end_line": 522,
+          "start_line": 504,
+          "end_line": 517,
           "tags": {},
           "relations": [],
           "children": [],
@@ -80546,8 +81537,8 @@
           "type": "Component",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 524,
-          "end_line": 543,
+          "start_line": 519,
+          "end_line": 538,
           "tags": {},
           "relations": [],
           "children": [],
@@ -80562,8 +81553,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 545,
-          "end_line": 576,
+          "start_line": 540,
+          "end_line": 571,
           "tags": {},
           "relations": [],
           "children": [],
@@ -80578,8 +81569,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 631,
-          "end_line": 672,
+          "start_line": 626,
+          "end_line": 667,
           "tags": {},
           "relations": [],
           "children": [],
@@ -80594,8 +81585,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 676,
-          "end_line": 702,
+          "start_line": 671,
+          "end_line": 697,
           "tags": {
             "PURPOSE": "Render overlay components for log viewing and password entry.",
             "UX_STATE": "[AwaitingInput] -> PasswordPrompt is visible."
@@ -82082,76 +83073,120 @@
     {
       "name": "MapperPage",
       "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 27,
+      "end_line": 35,
       "tags": {
-        "COMPLEXITY": "1",
+        "COMPLEXITY": "3",
         "SEMANTICS": "mapper, page, tool",
         "PURPOSE": "Page for the dataset column mapper tool.",
-        "LAYER": "UI"
+        "LAYER": "UI",
+        "UX_STATE": "Error -> Mapping-specific validation or execution failures remain visible without route changes."
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "MapperTool"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskRunner"
+        }
+      ],
       "children": [],
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 1.0
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 11
+          "line": 19
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 12
+          "line": 20
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 16
+          "line": 24
         }
       ]
     },
     {
       "name": "DebugPage",
       "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 27,
+      "end_line": 35,
       "tags": {
-        "COMPLEXITY": "1",
+        "COMPLEXITY": "3",
         "SEMANTICS": "debug, page, tool",
         "PURPOSE": "Page for system diagnostics and debugging.",
-        "LAYER": "UI"
+        "LAYER": "UI",
+        "UX_STATE": "Error -> Nested diagnostic failures remain scoped to the debug workspace."
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "DebugTool"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskRunner"
+        }
+      ],
       "children": [],
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 1.0
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 11
+          "line": 19
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 12
+          "line": 20
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 16
+          "line": 24
         }
       ]
     },
@@ -82161,12 +83196,8 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 1905,
+      "end_line": 1899,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
         "COMPLEXITY": "5",
         "PURPOSE": "Consolidated Settings Page - All settings in one place with tabbed navigation",
         "LAYER": "UI",
@@ -82199,7 +83230,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 1905,
+      "end_line": 1899,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/routes/settings/+page.svelte",
         "COMPLEXITY": "1",
@@ -82212,8 +83243,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 93,
-          "end_line": 93,
+          "start_line": 87,
+          "end_line": 87,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82231,8 +83262,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 112,
-          "end_line": 112,
+          "start_line": 106,
+          "end_line": 106,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82250,8 +83281,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 127,
-          "end_line": 127,
+          "start_line": 121,
+          "end_line": 121,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82269,8 +83300,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 137,
-          "end_line": 137,
+          "start_line": 131,
+          "end_line": 131,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82288,8 +83319,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 171,
-          "end_line": 171,
+          "start_line": 165,
+          "end_line": 165,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82307,8 +83338,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 186,
-          "end_line": 186,
+          "start_line": 180,
+          "end_line": 180,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82326,8 +83357,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 210,
-          "end_line": 210,
+          "start_line": 204,
+          "end_line": 204,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82345,8 +83376,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 224,
-          "end_line": 224,
+          "start_line": 218,
+          "end_line": 218,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82364,8 +83395,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 231,
-          "end_line": 231,
+          "start_line": 225,
+          "end_line": 225,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82383,8 +83414,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 239,
-          "end_line": 239,
+          "start_line": 233,
+          "end_line": 233,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82402,8 +83433,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 251,
-          "end_line": 251,
+          "start_line": 245,
+          "end_line": 245,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82421,8 +83452,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 269,
-          "end_line": 269,
+          "start_line": 263,
+          "end_line": 263,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82440,8 +83471,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 273,
-          "end_line": 273,
+          "start_line": 267,
+          "end_line": 267,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82459,8 +83490,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 277,
-          "end_line": 277,
+          "start_line": 271,
+          "end_line": 271,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82478,8 +83509,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 282,
-          "end_line": 282,
+          "start_line": 276,
+          "end_line": 276,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82497,8 +83528,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 311,
-          "end_line": 311,
+          "start_line": 305,
+          "end_line": 305,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82516,8 +83547,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 345,
-          "end_line": 345,
+          "start_line": 339,
+          "end_line": 339,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82535,8 +83566,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 358,
-          "end_line": 358,
+          "start_line": 352,
+          "end_line": 352,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82554,8 +83585,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 376,
-          "end_line": 376,
+          "start_line": 370,
+          "end_line": 370,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82573,8 +83604,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 384,
-          "end_line": 384,
+          "start_line": 378,
+          "end_line": 378,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82592,6 +83623,25 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
+          "start_line": 383,
+          "end_line": 383,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "saveMigrationSettings",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
           "start_line": 389,
           "end_line": 389,
           "tags": {
@@ -82606,32 +83656,13 @@
             "score": 1.0
           }
         },
-        {
-          "name": "saveMigrationSettings",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 395,
-          "end_line": 395,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
         {
           "name": "triggerSyncNow",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 407,
-          "end_line": 407,
+          "start_line": 401,
+          "end_line": 401,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82649,8 +83680,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 424,
-          "end_line": 424,
+          "start_line": 418,
+          "end_line": 418,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82668,8 +83699,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 435,
-          "end_line": 435,
+          "start_line": 429,
+          "end_line": 429,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82687,8 +83718,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 451,
-          "end_line": 451,
+          "start_line": 445,
+          "end_line": 445,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82706,8 +83737,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 476,
-          "end_line": 476,
+          "start_line": 470,
+          "end_line": 470,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82725,8 +83756,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 496,
-          "end_line": 496,
+          "start_line": 490,
+          "end_line": 490,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82744,8 +83775,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 513,
-          "end_line": 513,
+          "start_line": 507,
+          "end_line": 507,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82763,8 +83794,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 553,
-          "end_line": 553,
+          "start_line": 547,
+          "end_line": 547,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82782,8 +83813,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 570,
-          "end_line": 570,
+          "start_line": 564,
+          "end_line": 564,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82801,8 +83832,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 574,
-          "end_line": 574,
+          "start_line": 568,
+          "end_line": 568,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -82820,7 +83851,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 1905 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 1899 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -82995,24 +84026,47 @@
     {
       "name": "ConnectionsSettingsPage",
       "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 41,
+      "end_line": 50,
       "tags": {
+        "COMPLEXITY": "3",
         "SEMANTICS": "settings, connections, page",
         "PURPOSE": "Page for managing database connection configurations.",
-        "LAYER": "UI"
+        "LAYER": "UI",
+        "UX_STATE": "Error -> Child components surface validation or request errors inline."
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "ConnectionForm"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "ConnectionList"
+        }
+      ],
       "children": [
         {
           "name": "handleSuccess",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 14,
-          "end_line": 24,
+          "start_line": 23,
+          "end_line": 33,
           "tags": {
             "PURPOSE": "Refreshes the connection list after a successful creation.",
             "PRE": "listComponent must be bound.",
@@ -83030,18 +84084,18 @@
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 1.0
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 10
+          "line": 19
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 29
+          "line": 38
         }
       ]
     },
@@ -83051,14 +84105,27 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 532,
+      "end_line": 539,
       "tags": {
         "SEMANTICS": "git, settings, configuration, integration",
         "PURPOSE": "Manage Git server configurations for dashboard versioning.",
         "LAYER": "Page",
+        "UX_STATE": "Error -> Toast feedback reports failures while preserving entered configuration values.",
         "INVARIANT": "All configurations must be validated via connection test."
       },
       "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        },
         {
           "type": "USES",
           "target": "gitService"
@@ -83074,8 +84141,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 48,
-          "end_line": 61,
+          "start_line": 55,
+          "end_line": 68,
           "tags": {
             "PURPOSE": "Fetches existing git configurations.",
             "PRE": "Component is mounted.",
@@ -83094,8 +84161,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 65,
-          "end_line": 93,
+          "start_line": 72,
+          "end_line": 100,
           "tags": {
             "PURPOSE": "Tests connection to a git server with current form data.",
             "PRE": "newConfig contains valid provider, url, and pat.",
@@ -83114,8 +84181,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 95,
-          "end_line": 129,
+          "start_line": 102,
+          "end_line": 136,
           "tags": {
             "PURPOSE": "Saves a new git configuration.",
             "PRE": "newConfig is valid and tested.",
@@ -83134,8 +84201,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 131,
-          "end_line": 151,
+          "start_line": 138,
+          "end_line": 158,
           "tags": {
             "PURPOSE": "Populates the form with an existing config to edit.",
             "PARAM": "{Object} config - Configuration object to edit.",
@@ -83154,8 +84221,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 153,
-          "end_line": 169,
+          "start_line": 160,
+          "end_line": 176,
           "tags": {
             "PURPOSE": "Resets the configuration form."
           },
@@ -83172,8 +84239,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 170,
-          "end_line": 191,
+          "start_line": 177,
+          "end_line": 198,
           "tags": {
             "PURPOSE": "Deletes a git configuration by ID.",
             "PARAM": "{string} id - Configuration ID.",
@@ -83193,8 +84260,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 193,
-          "end_line": 216,
+          "start_line": 200,
+          "end_line": 223,
           "tags": {
             "PURPOSE": "Loads repositories from selected Gitea config.",
             "PRE": "selectedGiteaConfigId is set.",
@@ -83213,8 +84280,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 218,
-          "end_line": 247,
+          "start_line": 225,
+          "end_line": 254,
           "tags": {
             "PURPOSE": "Creates new repository on selected Gitea server.",
             "PRE": "selectedGiteaConfigId and newGiteaRepo.name are set.",
@@ -83233,8 +84300,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 249,
-          "end_line": 282,
+          "start_line": 256,
+          "end_line": 289,
           "tags": {
             "PURPOSE": "Deletes repository from selected Gitea server.",
             "PRE": "selectedGiteaConfigId is set.",
@@ -83269,57 +84336,22 @@
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 17
+          "line": 24
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 18
+          "line": 25
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 22
+          "line": 29
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 23
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 31
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 32
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 33
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 34
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 35
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 36
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 37
+          "line": 30
         },
         {
           "store": "state",
@@ -83332,134 +84364,169 @@
           "line": 39
         },
         {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 80
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 40
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 41
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 42
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 43
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 44
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 45
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 46
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 83
+          "line": 87
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 88
+          "line": 90
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 112
+          "line": 95
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 120
+          "line": 119
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 178
+          "line": 127
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 182
+          "line": 185
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 189
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 284
+          "line": 291
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 293
+          "line": 300
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 297
+          "line": 304
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 299
+          "line": 306
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 330
+          "line": 337
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 346
+          "line": 353
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 371
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 372
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 376
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
           "line": 378
         },
         {
           "store": "t",
-          "type": "WRITES_TO",
-          "line": 381
+          "type": "READS_FROM",
+          "line": 379
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 390
+          "line": 383
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 394
+          "line": 385
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 399
+          "line": 388
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 404
+          "line": 397
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 401
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 406
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 411
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 416
+          "line": 423
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 420
+          "line": 427
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 422
+          "line": 429
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 426
+          "line": 433
         }
       ]
     },
@@ -83727,24 +84794,47 @@
     {
       "name": "GitDashboardPage",
       "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 126,
+      "end_line": 136,
       "tags": {
+        "COMPLEXITY": "3",
         "PURPOSE": "Dashboard management page for Git integration.",
         "LAYER": "Page",
-        "SEMANTICS": "git, dashboard, management, ui"
+        "SEMANTICS": "git, dashboard, management, ui",
+        "UX_STATE": "Error -> Toast-driven failure feedback preserves the current filter selection."
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "RoutePages"
+        },
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "NavigationContracts"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "RepositoryDashboardGrid"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "environmentContextStore"
+        }
+      ],
       "children": [
         {
           "name": "fetchEnvironments",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 32,
-          "end_line": 46,
+          "start_line": 42,
+          "end_line": 56,
           "tags": {
             "PURPOSE": "Fetches the list of deployment environments from the API.",
             "PRE": "Component is mounted.",
@@ -83763,8 +84853,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 48,
-          "end_line": 81,
+          "start_line": 58,
+          "end_line": 91,
           "tags": {
             "PURPOSE": "Fetches dashboards for a specific environment.",
             "PRE": "`envId` is a valid environment ID.",
@@ -83782,101 +84872,107 @@
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 1.0
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 14
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 15
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 20
-        },
-        {
-          "store": "state",
-          "type": "WRITES_TO",
           "line": 24
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
+          "store": "lib",
+          "type": "READS_FROM",
           "line": 25
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 26
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 30
         },
         {
           "store": "state",
           "type": "WRITES_TO",
-          "line": 27
+          "line": 34
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 35
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 36
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 37
         },
         {
           "store": "derived",
           "type": "WRITES_TO",
-          "line": 28
+          "line": 38
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 85
+          "line": 95
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 92
+          "line": 102
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 100
+          "line": 110
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 103
+          "line": 113
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 115
+          "line": 125
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 117
+          "line": 127
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 121
+          "line": 131
         }
       ]
     },
     {
       "name": "Dashboard",
       "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 64,
+      "end_line": 69,
       "tags": {
+        "COMPLEXITY": "3",
         "SEMANTICS": "dashboard, plugins, tools, list",
         "PURPOSE": "Displays the list of available plugins and allows selecting one.",
         "LAYER": "UI",
+        "UX_STATE": "Empty -> No plugin tiles are shown when the list is empty.",
         "PROPS": "None",
         "EVENTS": "None"
       },
       "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
         {
           "type": "DEPENDS_ON",
           "target": "stores"
@@ -83888,8 +84984,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 17,
-          "end_line": 27,
+          "start_line": 22,
+          "end_line": 32,
           "tags": {
             "PURPOSE": "Fetch plugins when the component mounts.",
             "PRE": "Component is mounting.",
@@ -83908,8 +85004,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 29,
-          "end_line": 40,
+          "start_line": 34,
+          "end_line": 45,
           "tags": {
             "PURPOSE": "Selects a plugin to display its form.",
             "PRE": "plugin object is provided.",
@@ -83928,32 +85024,38 @@
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 1.0
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "plugins",
           "type": "READS_FROM",
-          "line": 47
+          "line": 52
         }
       ]
     },
     {
       "name": "Settings",
       "type": "Component",
-      "complexity": 1,
-      "tier": "TRIVIAL",
+      "complexity": 3,
+      "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 341,
+      "end_line": 346,
       "tags": {
+        "COMPLEXITY": "3",
         "SEMANTICS": "settings, ui, configuration",
         "PURPOSE": "The main settings page for the application, allowing management of environments and global settings.",
         "LAYER": "UI",
+        "UX_STATE": "Error -> Toast and inline feedback preserve the current settings context for retry.",
         "PROPS": "None",
         "EVENTS": "None",
         "INVARIANT": "Settings changes must be saved to the backend."
       },
       "relations": [
+        {
+          "type": "IMPLEMENTS",
+          "target": "PageContracts"
+        },
         {
           "type": "CALLS",
           "target": "api.js"
@@ -83969,8 +85071,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 50,
-          "end_line": 67,
+          "start_line": 55,
+          "end_line": 72,
           "tags": {
             "PURPOSE": "Loads settings from the backend.",
             "PRE": "Component mounted or refresh requested.",
@@ -83989,8 +85091,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 69,
-          "end_line": 86,
+          "start_line": 74,
+          "end_line": 91,
           "tags": {
             "PURPOSE": "Saves global settings to the backend.",
             "PRE": "settings.settings contains valid configuration.",
@@ -84009,8 +85111,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 88,
-          "end_line": 112,
+          "start_line": 93,
+          "end_line": 117,
           "tags": {
             "PURPOSE": "Adds or updates an environment.",
             "PRE": "newEnv contains valid environment details.",
@@ -84029,8 +85131,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 114,
-          "end_line": 135,
+          "start_line": 119,
+          "end_line": 140,
           "tags": {
             "PURPOSE": "Deletes an environment.",
             "PRE": "id of environment to delete is provided.",
@@ -84050,8 +85152,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 137,
-          "end_line": 160,
+          "start_line": 142,
+          "end_line": 165,
           "tags": {
             "PURPOSE": "Tests the connection to an environment.",
             "PRE": "Environment ID is valid.",
@@ -84071,8 +85173,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 162,
-          "end_line": 173,
+          "start_line": 167,
+          "end_line": 178,
           "tags": {
             "PURPOSE": "Sets the form to edit an existing environment.",
             "PRE": "env object is provided.",
@@ -84092,8 +85194,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 175,
-          "end_line": 196,
+          "start_line": 180,
+          "end_line": 201,
           "tags": {
             "PURPOSE": "Resets the environment form.",
             "PRE": "None.",
@@ -84117,48 +85219,43 @@
             "line_number": 1
           }
         ],
-        "score": 0.85
+        "score": 0.75
       },
       "data_flow": [
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 64
+          "line": 69
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 79
+          "line": 84
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 83
+          "line": 88
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 99
+          "line": 104
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 102
+          "line": 107
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 109
+          "line": 114
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 122
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
-          "line": 126
+          "line": 127
         },
         {
           "store": "t",
@@ -84168,12 +85265,12 @@
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 149
+          "line": 136
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 152
+          "line": 154
         },
         {
           "store": "t",
@@ -84182,13 +85279,8 @@
         },
         {
           "store": "t",
-          "type": "WRITES_TO",
-          "line": 203
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 206
+          "type": "READS_FROM",
+          "line": 162
         },
         {
           "store": "t",
@@ -84203,132 +85295,137 @@
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 221
+          "line": 213
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 222
+          "line": 216
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 225
+          "line": 226
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 229
+          "line": 227
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 235
+          "line": 230
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 234
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 240
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 241
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
           "line": 246
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 250
-        },
-        {
-          "store": "t",
-          "type": "READS_FROM",
           "line": 251
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 259
+          "line": 255
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 256
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 260
+          "line": 264
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 261
+          "line": 265
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 262
+          "line": 266
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 263
+          "line": 267
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 272
+          "line": 268
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 272
+          "line": 277
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 274
+          "line": 277
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 275
+          "line": 279
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 276
+          "line": 280
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 285
+          "line": 281
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 285
+          "line": 290
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 288
+          "line": 290
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 292
+          "line": 293
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 296
+          "line": 297
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 300
+          "line": 301
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 304
+          "line": 305
         },
         {
           "store": "t",
@@ -84338,22 +85435,12 @@
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 313
+          "line": 314
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 317
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 320
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 321
+          "line": 318
         },
         {
           "store": "t",
@@ -84362,18 +85449,33 @@
         },
         {
           "store": "t",
-          "type": "READS_FROM",
-          "line": 328
+          "type": "WRITES_TO",
+          "line": 325
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 326
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 327
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 328
+          "line": 333
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 332
+          "line": 333
+        },
+        {
+          "store": "t",
+          "type": "READS_FROM",
+          "line": 337
         }
       ]
     },
@@ -86086,19 +87188,17 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 310,
+      "end_line": 306,
       "tags": {
-        "SIDE_EFFECT": "None",
         "UX_STATE": "Error -> Shows error message with recovery option",
-        "PRE": "Needs a valid taskId to fetch logs for.",
-        "POST": "task logs are displayed and updated in real time.",
-        "DATA_CONTRACT": "Default state data",
-        "COMPLEXITY": "5",
+        "COMPLEXITY": "3",
         "SEMANTICS": "task, log, viewer, inline, realtime",
         "PURPOSE": "Displays detailed logs for a specific task inline or in a modal using TaskLogPanel.",
         "LAYER": "UI",
         "INVARIANT": "Real-time logs are always appended without duplicates.",
         "TIER": "CRITICAL",
+        "PRE": "Needs a valid taskId to fetch logs for.",
+        "POST": "task logs are displayed and updated in real time.",
         "UX_FEEDBACK": "Auto-scroll keeps newest logs visible",
         "UX_RECOVERY": "Refresh button re-fetches logs from API",
         "TEST_CONTRACT": "Component_TaskLogViewer ->",
@@ -86122,8 +87222,8 @@
           "type": "Action",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 67,
-          "end_line": 84,
+          "start_line": 63,
+          "end_line": 80,
           "tags": {
             "PURPOSE": "Sync real-time logs to the current log list",
             "PRE": "None",
@@ -86142,8 +87242,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 86,
-          "end_line": 106,
+          "start_line": 82,
+          "end_line": 102,
           "tags": {
             "PURPOSE": "Fetches logs for a given task ID",
             "PRE": "taskId is set",
@@ -86162,8 +87262,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 108,
-          "end_line": 116,
+          "start_line": 104,
+          "end_line": 112,
           "tags": {
             "PURPOSE": "Updates filter conditions for the log viewer",
             "PRE": "event contains source and level fields",
@@ -86182,8 +87282,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 118,
-          "end_line": 126,
+          "start_line": 114,
+          "end_line": 122,
           "tags": {
             "PURPOSE": "Refreshes the logs by polling the API",
             "PRE": "None",
@@ -86202,8 +87302,8 @@
           "type": "Component",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 154,
-          "end_line": 196,
+          "start_line": 150,
+          "end_line": 192,
           "tags": {
             "UX_STATE": "Loading -> Default",
             "PURPOSE": "Shows inline logs -->",
@@ -86224,12 +87324,12 @@
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 154
+                "line_number": 150
               },
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 154
+                "line_number": 150
               }
             ],
             "score": 0.7
@@ -86240,8 +87340,8 @@
           "type": "Component",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 198,
-          "end_line": 308,
+          "start_line": 194,
+          "end_line": 304,
           "tags": {
             "UX_STATE": "Loading -> Default",
             "PURPOSE": "Shows modal logs -->",
@@ -86262,12 +87362,12 @@
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 198
+                "line_number": 194
               },
               {
                 "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 198
+                "line_number": 194
               }
             ],
             "score": 0.7
@@ -86294,11 +87394,26 @@
         {
           "store": "bindable",
           "type": "WRITES_TO",
-          "line": 51
+          "line": 47
         },
         {
           "store": "props",
           "type": "WRITES_TO",
+          "line": 53
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 55
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
+          "line": 56
+        },
+        {
+          "store": "state",
+          "type": "WRITES_TO",
           "line": 57
         },
         {
@@ -86307,64 +87422,49 @@
           "line": 59
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 60
-        },
-        {
-          "store": "state",
+          "store": "derived",
           "type": "WRITES_TO",
           "line": 61
         },
         {
-          "store": "state",
-          "type": "WRITES_TO",
-          "line": 63
-        },
-        {
-          "store": "derived",
-          "type": "WRITES_TO",
-          "line": 65
+          "store": "effect",
+          "type": "READS_FROM",
+          "line": 67
         },
         {
           "store": "effect",
           "type": "READS_FROM",
-          "line": 71
-        },
-        {
-          "store": "effect",
-          "type": "READS_FROM",
-          "line": 128
+          "line": 124
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 172
+          "line": 168
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 184
+          "line": 180
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 249
+          "line": 245
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 257
+          "line": 253
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 271
+          "line": 267
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 290
+          "line": 286
         }
       ]
     },
@@ -86761,112 +87861,114 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 86,
+      "end_line": 89,
       "tags": {
-        "UX_STATE": "Loading -> Default",
         "COMPLEXITY": "3",
         "SEMANTICS": "navbar, navigation, header, layout",
         "PURPOSE": "Main navigation bar for the application.",
-        "LAYER": "UI"
+        "LAYER": "UI",
+        "UX_STATE": "Authenticated -> User identity and logout action are rendered."
       },
       "relations": [
         {
-          "type": "USES",
+          "type": "BINDS_TO",
           "target": "auth"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "i18n"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "LanguageSwitcher"
         }
       ],
       "children": [],
       "compliance": {
         "valid": true,
-        "issues": [
-          {
-            "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 1
-          }
-        ],
-        "score": 0.75
+        "issues": [],
+        "score": 0.9
       },
       "data_flow": [
         {
           "store": "app",
           "type": "READS_FROM",
-          "line": 12
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
-          "line": 14
-        },
-        {
-          "store": "lib",
-          "type": "READS_FROM",
           "line": 15
         },
         {
           "store": "lib",
           "type": "READS_FROM",
-          "line": 16
+          "line": 17
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 18
+        },
+        {
+          "store": "lib",
+          "type": "READS_FROM",
+          "line": 19
         },
         {
           "store": "app",
           "type": "READS_FROM",
-          "line": 17
+          "line": 20
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 39
+          "line": 42
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 45
+          "line": 48
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 49
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
           "line": 52
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 53
+          "line": 55
         },
         {
           "store": "t",
           "type": "WRITES_TO",
-          "line": 54
+          "line": 56
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 57
         },
         {
           "store": "t",
           "type": "READS_FROM",
-          "line": 61
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
           "line": 64
         },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 65
-        },
-        {
-          "store": "t",
-          "type": "WRITES_TO",
-          "line": 66
-        },
         {
           "store": "t",
           "type": "WRITES_TO",
           "line": 67
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 68
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 69
+        },
+        {
+          "store": "t",
+          "type": "WRITES_TO",
+          "line": 70
         }
       ]
     },
@@ -86876,7 +87978,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 86,
+      "end_line": 89,
       "tags": {
         "PURPOSE": "Auto-generated module for frontend/src/components/Navbar.svelte",
         "COMPLEXITY": "1",
@@ -86889,8 +87991,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 21,
-          "end_line": 21,
+          "start_line": 24,
+          "end_line": 24,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -87166,22 +88268,21 @@
     {
       "name": "Toast",
       "type": "Component",
-      "complexity": 1,
+      "complexity": 2,
       "tier": "TRIVIAL",
       "start_line": 1,
       "end_line": 32,
       "tags": {
-        "COMPLEXITY": "1",
+        "COMPLEXITY": "2",
         "SEMANTICS": "toast, notification, feedback, ui",
         "PURPOSE": "Displays transient notifications (toasts) in the bottom-right corner.",
         "LAYER": "UI",
-        "PROPS": "None",
-        "EVENTS": "None"
+        "UX_STATE": "Visible -> Active toast items render with type-specific emphasis."
       },
       "relations": [
         {
-          "type": "DEPENDS_ON",
-          "target": "frontend/src/lib/toasts.js"
+          "type": "BINDS_TO",
+          "target": "toasts"
         }
       ],
       "children": [],
@@ -88217,13 +89318,9 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 149,
+      "end_line": 144,
       "tags": {
-        "PRE": "Default pre condition",
-        "DATA_CONTRACT": "Default state data",
-        "SIDE_EFFECT": "None",
-        "POST": "Default post condition",
-        "COMPLEXITY": "5",
+        "COMPLEXITY": "3",
         "SEMANTICS": "auth, route-guard, permission, redirect, session-validation",
         "PURPOSE": "Enforces authenticated and authorized access before protected route content is rendered.",
         "LAYER": "UI",
@@ -88262,8 +89359,8 @@
           "type": "Component",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 36,
-          "end_line": 148,
+          "start_line": 31,
+          "end_line": 143,
           "tags": {
             "PURPOSE": "Wraps protected slot content with session and permission verification guards.",
             "PRE": "auth store and navigation API are available in runtime; component is mounted in a browser context.",
@@ -88278,8 +89375,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 66,
-              "end_line": 133,
+              "start_line": 61,
+              "end_line": 128,
               "tags": {
                 "PURPOSE": "Validates session and optional permission gate before allowing protected content render.",
                 "PRE": "auth store is initialized and can provide token/user state; navigation is available.",
@@ -92536,7 +93633,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": null,
+      "end_line": 61,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "llm, provider-config, integration-test, edit-flow, delete-flow",
@@ -92590,20 +93687,15 @@
         }
       ],
       "compliance": {
-        "valid": false,
+        "valid": true,
         "issues": [
-          {
-            "message": "Unclosed Anchor: [DEF:ProviderConfigIntegrationTest:Module] started at line 1",
-            "severity": "ERROR",
-            "line_number": 1
-          },
           {
             "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
             "severity": "WARNING",
             "line_number": 1
           }
         ],
-        "score": 0.0
+        "score": 0.775
       }
     },
     {
@@ -92662,7 +93754,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 424,
+      "end_line": 499,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "app, main, entrypoint, fastapi",
@@ -92686,18 +93778,27 @@
       ],
       "children": [
         {
-          "name": "App",
+          "name": "FastAPI_App",
           "type": "Global",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 38,
-          "end_line": 47,
+          "complexity": 3,
+          "tier": "STANDARD",
+          "start_line": 59,
+          "end_line": 70,
           "tags": {
-            "COMPLEXITY": "1",
-            "SEMANTICS": "app, fastapi, instance",
-            "PURPOSE": "The global FastAPI application instance."
+            "COMPLEXITY": "3",
+            "SEMANTICS": "app, fastapi, instance, route-registry",
+            "PURPOSE": "Canonical FastAPI application instance for route, middleware, and websocket registration."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "ApiRoutesModule"
+            },
+            {
+              "type": "BINDS_TO",
+              "target": "API_Routes"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -92710,8 +93811,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 49,
-          "end_line": 95,
+          "start_line": 73,
+          "end_line": 125,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Ensures initial admin user exists when bootstrap env flags are enabled."
@@ -92724,12 +93825,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 49
+                "line_number": 73
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 49
+                "line_number": 73
               }
             ],
             "score": 0.5499999999999999
@@ -92740,8 +93841,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 97,
-          "end_line": 111,
+          "start_line": 128,
+          "end_line": 144,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Handles application startup tasks, such as starting the scheduler.",
@@ -92766,8 +93867,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 113,
-          "end_line": 125,
+          "start_line": 147,
+          "end_line": 161,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Handles application shutdown tasks, such as stopping the scheduler.",
@@ -92792,8 +93893,8 @@
           "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 127,
-          "end_line": 141,
+          "start_line": 163,
+          "end_line": 178,
           "tags": {
             "PURPOSE": "Configure application-wide middleware (Session, CORS)."
           },
@@ -92810,8 +93911,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 144,
-          "end_line": 159,
+          "start_line": 181,
+          "end_line": 198,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Global exception handler for NetworkError.",
@@ -92832,8 +93933,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 161,
-          "end_line": 189,
+          "start_line": 201,
+          "end_line": 233,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Middleware to log incoming HTTP requests and their response status.",
@@ -92855,16 +93956,62 @@
           }
         },
         {
-          "name": "api_routes",
+          "name": "API_Routes",
           "type": "Block",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 191,
-          "end_line": 215,
+          "complexity": 3,
+          "tier": "STANDARD",
+          "start_line": 235,
+          "end_line": 273,
           "tags": {
-            "PURPOSE": "Register all application API routers."
+            "COMPLEXITY": "3",
+            "PURPOSE": "Register all FastAPI route groups exposed by the application entrypoint."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "FastAPI_App"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "Route_Group_Contracts"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "AuthApi"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "AdminApi"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "PluginsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "TasksRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "SettingsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ConnectionsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ReportsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LlmRoutes"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "CleanReleaseV2Api"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -92877,8 +94024,8 @@
           "type": "Action",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 218,
-          "end_line": 223,
+          "start_line": 276,
+          "end_line": 281,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Registers all API routers with the FastAPI application.",
@@ -92898,8 +94045,8 @@
           "type": "Function",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 225,
-          "end_line": 382,
+          "start_line": 284,
+          "end_line": 445,
           "tags": {
             "COMPLEXITY": "5",
             "PURPOSE": "Provides a WebSocket endpoint for real-time log streaming of a task with server-side filtering.",
@@ -92936,8 +94083,8 @@
           "type": "Mount",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 384,
-          "end_line": 423,
+          "start_line": 447,
+          "end_line": 498,
           "tags": {
             "COMPLEXITY": "1",
             "SEMANTICS": "static, frontend, spa",
@@ -92950,8 +94097,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 392,
-              "end_line": 411,
+              "start_line": 457,
+              "end_line": 483,
               "tags": {
                 "COMPLEXITY": "1",
                 "PURPOSE": "Serves the SPA frontend for any path not matched by API routes.",
@@ -92971,8 +94118,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 413,
-              "end_line": 422,
+              "start_line": 485,
+              "end_line": 497,
               "tags": {
                 "COMPLEXITY": "1",
                 "PURPOSE": "A simple root endpoint to confirm that the API is running when frontend is missing.",
@@ -92999,8 +94146,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 290,
-          "end_line": 290,
+          "start_line": 346,
+          "end_line": 346,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93018,7 +94165,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 424 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 499 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -93384,12 +94531,12 @@
       }
     },
     {
-      "name": "backend.src.scripts.seed_superset_load_test",
+      "name": "SeedSupersetLoadTestScript",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 300,
+      "end_line": 399,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "superset, load-test, charts, dashboards, seed, stress",
@@ -93400,11 +94547,11 @@
       "relations": [
         {
           "type": "USES",
-          "target": "backend.src.core.config_manager.ConfigManager"
+          "target": "ConfigManager"
         },
         {
           "type": "USES",
-          "target": "backend.src.core.superset_client.SupersetClient"
+          "target": "SupersetClient"
         }
       ],
       "children": [
@@ -93414,7 +94561,7 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 29,
-          "end_line": 43,
+          "end_line": 70,
           "tags": {
             "PURPOSE": "Parses CLI arguments for load-test data generation.",
             "PRE": "Script is called from CLI.",
@@ -93433,8 +94580,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 46,
-          "end_line": 55,
+          "start_line": 73,
+          "end_line": 84,
           "tags": {
             "PURPOSE": "Normalizes Superset API payloads that may be wrapped in `result`.",
             "PRE": "payload is a JSON-decoded API response.",
@@ -93453,8 +94600,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 58,
-          "end_line": 70,
+          "start_line": 87,
+          "end_line": 101,
           "tags": {
             "PURPOSE": "Extracts object ID from create/update API response.",
             "PRE": "payload is a JSON-decoded API response.",
@@ -93473,8 +94620,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 73,
-          "end_line": 86,
+          "start_line": 104,
+          "end_line": 141,
           "tags": {
             "PURPOSE": "Generates globally unique random names for charts/dashboards.",
             "PRE": "used_names is mutable set for collision tracking.",
@@ -93493,8 +94640,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 89,
-          "end_line": 118,
+          "start_line": 144,
+          "end_line": 177,
           "tags": {
             "PURPOSE": "Resolves requested environment IDs from configuration.",
             "PRE": "env_ids is non-empty.",
@@ -93513,8 +94660,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 121,
-          "end_line": 175,
+          "start_line": 180,
+          "end_line": 252,
           "tags": {
             "PURPOSE": "Builds a pool of source chart templates to clone in one environment.",
             "PRE": "Client is authenticated.",
@@ -93533,8 +94680,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 178,
-          "end_line": 280,
+          "start_line": 255,
+          "end_line": 377,
           "tags": {
             "PURPOSE": "Creates dashboards and cloned charts for load testing across target environments.",
             "PRE": "Target environments must be reachable and authenticated.",
@@ -93554,8 +94701,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 283,
-          "end_line": 294,
+          "start_line": 380,
+          "end_line": 393,
           "tags": {
             "PURPOSE": "CLI entrypoint for Superset load-test data seeding.",
             "PRE": "Command line arguments are valid.",
@@ -93584,7 +94731,7 @@
             "line_number": 1
           },
           {
-            "message": "Fractal limit warning: Module length is 300 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 399 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -93633,12 +94780,12 @@
       }
     },
     {
-      "name": "backend.src.scripts.clean_release_tui",
+      "name": "CleanReleaseTuiScript",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 600,
+      "end_line": 684,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "clean-release, tui, ncurses, interactive-validator",
@@ -93649,11 +94796,11 @@
       "relations": [
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.services.clean_release.compliance_orchestrator"
+          "target": "compliance_orchestrator"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.services.clean_release.repository"
+          "target": "repository"
         }
       ],
       "children": [
@@ -93662,8 +94809,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 46,
-          "end_line": 142,
+          "start_line": 49,
+          "end_line": 192,
           "tags": {
             "PURPOSE": "Thin TUI adapter that routes business mutations through application services.",
             "PRE": "repository contains candidate and trusted policy/registry snapshots for execution.",
@@ -93682,8 +94829,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 145,
-          "end_line": 573,
+          "start_line": 195,
+          "end_line": 657,
           "tags": {
             "PURPOSE": "Curses-based application for compliance monitoring.",
             "UX_STATE": "BLOCKED -> Violations detected, release forbidden.",
@@ -93696,8 +94843,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 436,
-              "end_line": 475,
+              "start_line": 511,
+              "end_line": 555,
               "tags": {
                 "PURPOSE": "Execute compliance run via facade adapter and update UI state.",
                 "PRE": "Candidate and policy snapshots are present in repository.",
@@ -93723,8 +94870,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 51,
-          "end_line": 51,
+          "start_line": 54,
+          "end_line": 54,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93742,8 +94889,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 54,
-          "end_line": 54,
+          "start_line": 57,
+          "end_line": 57,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93761,8 +94908,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 66,
-          "end_line": 66,
+          "start_line": 69,
+          "end_line": 69,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93780,8 +94927,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 77,
-          "end_line": 77,
+          "start_line": 86,
+          "end_line": 86,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93799,8 +94946,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 90,
-          "end_line": 90,
+          "start_line": 103,
+          "end_line": 103,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93818,8 +94965,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 104,
-          "end_line": 104,
+          "start_line": 121,
+          "end_line": 121,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93837,8 +94984,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 111,
-          "end_line": 111,
+          "start_line": 128,
+          "end_line": 128,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93856,8 +95003,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 153,
-          "end_line": 153,
+          "start_line": 203,
+          "end_line": 203,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93875,8 +95022,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 175,
-          "end_line": 175,
+          "start_line": 225,
+          "end_line": 225,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93894,8 +95041,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 183,
-          "end_line": 183,
+          "start_line": 233,
+          "end_line": 233,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93913,8 +95060,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 256,
-          "end_line": 256,
+          "start_line": 306,
+          "end_line": 306,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93932,8 +95079,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 325,
-          "end_line": 325,
+          "start_line": 377,
+          "end_line": 377,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93951,8 +95098,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 335,
-          "end_line": 335,
+          "start_line": 387,
+          "end_line": 387,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93970,8 +95117,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 353,
-          "end_line": 353,
+          "start_line": 405,
+          "end_line": 405,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -93989,8 +95136,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 386,
-          "end_line": 386,
+          "start_line": 441,
+          "end_line": 441,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -94008,8 +95155,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 397,
-          "end_line": 397,
+          "start_line": 452,
+          "end_line": 452,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -94027,8 +95174,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 430,
-          "end_line": 430,
+          "start_line": 503,
+          "end_line": 503,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -94046,139 +95193,6 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 477,
-          "end_line": 477,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "clear_history",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 490,
-          "end_line": 490,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "approve_latest",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 499,
-          "end_line": 499,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "publish_latest",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 512,
-          "end_line": 512,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "refresh_overview",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 525,
-          "end_line": 525,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "refresh_overview",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 538,
-          "end_line": 538,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "refresh_screen",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 544,
-          "end_line": 544,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "loop",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
           "start_line": 557,
           "end_line": 557,
           "tags": {
@@ -94193,13 +95207,146 @@
             "score": 1.0
           }
         },
+        {
+          "name": "clear_history",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 572,
+          "end_line": 572,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "approve_latest",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 581,
+          "end_line": 581,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "publish_latest",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 594,
+          "end_line": 594,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "refresh_overview",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 607,
+          "end_line": 607,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "refresh_overview",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 620,
+          "end_line": 620,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "refresh_screen",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 626,
+          "end_line": 626,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "loop",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 639,
+          "end_line": 639,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "tui_main",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 576,
-          "end_line": 576,
+          "start_line": 660,
+          "end_line": 660,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -94217,8 +95364,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 582,
-          "end_line": 582,
+          "start_line": 666,
+          "end_line": 666,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -94236,7 +95383,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 600 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 684 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -94245,12 +95392,12 @@
       }
     },
     {
-      "name": "backend.src.scripts.migrate_sqlite_to_postgres",
+      "name": "MigrateSqliteToPostgresScript",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 361,
+      "end_line": 402,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "migration, sqlite, postgresql, config, task_logs, task_records",
@@ -94287,7 +95434,7 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 30,
-          "end_line": 35,
+          "end_line": 38,
           "tags": {},
           "relations": [],
           "children": [],
@@ -94302,8 +95449,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 38,
-          "end_line": 59,
+          "start_line": 41,
+          "end_line": 64,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Parses JSON-like values from SQLite TEXT/JSON columns to Python objects.",
@@ -94318,12 +95465,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 38
+                "line_number": 41
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 38
+                "line_number": 41
               }
             ],
             "score": 0.5499999999999999
@@ -94334,8 +95481,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 62,
-          "end_line": 78,
+          "start_line": 67,
+          "end_line": 85,
           "tags": {
             "PURPOSE": "Resolves the existing legacy config.json path from candidates."
           },
@@ -94352,8 +95499,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 81,
-          "end_line": 88,
+          "start_line": 88,
+          "end_line": 97,
           "tags": {
             "PURPOSE": "Opens a SQLite connection with row factory."
           },
@@ -94370,8 +95517,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 91,
-          "end_line": 153,
+          "start_line": 100,
+          "end_line": 164,
           "tags": {
             "PURPOSE": "Ensures required PostgreSQL tables exist before migration."
           },
@@ -94388,8 +95535,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 156,
-          "end_line": 179,
+          "start_line": 167,
+          "end_line": 197,
           "tags": {
             "PURPOSE": "Migrates legacy config.json into app_configurations(global)."
           },
@@ -94406,8 +95553,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 182,
-          "end_line": 295,
+          "start_line": 200,
+          "end_line": 326,
           "tags": {
             "PURPOSE": "Migrates task_records and task_logs from SQLite into PostgreSQL."
           },
@@ -94424,8 +95571,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 298,
-          "end_line": 316,
+          "start_line": 329,
+          "end_line": 353,
           "tags": {
             "PURPOSE": "Orchestrates migration from SQLite/file to PostgreSQL."
           },
@@ -94442,8 +95589,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 319,
-          "end_line": 359,
+          "start_line": 356,
+          "end_line": 400,
           "tags": {
             "PURPOSE": "CLI entrypoint."
           },
@@ -94485,7 +95632,7 @@
             "line_number": 1
           },
           {
-            "message": "Fractal limit warning: Module length is 361 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 402 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -94494,12 +95641,12 @@
       }
     },
     {
-      "name": "backend.src.scripts.clean_release_cli",
+      "name": "CleanReleaseCliScript",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 444,
+      "end_line": 508,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "cli, clean-release, candidate, artifacts, manifest",
@@ -94513,8 +95660,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 21,
-          "end_line": 91,
+          "start_line": 29,
+          "end_line": 101,
           "tags": {
             "PURPOSE": "Build argparse parser for clean release CLI."
           },
@@ -94531,8 +95678,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 94,
-          "end_line": 117,
+          "start_line": 104,
+          "end_line": 130,
           "tags": {
             "PURPOSE": "Register candidate in repository via CLI command.",
             "PRE": "Candidate ID must be unique.",
@@ -94551,8 +95698,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 120,
-          "end_line": 147,
+          "start_line": 133,
+          "end_line": 163,
           "tags": {
             "PURPOSE": "Import single artifact for existing candidate.",
             "PRE": "Candidate must exist.",
@@ -94571,8 +95718,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 150,
-          "end_line": 171,
+          "start_line": 166,
+          "end_line": 197,
           "tags": {
             "PURPOSE": "Build immutable manifest snapshot for candidate.",
             "PRE": "Candidate must exist.",
@@ -94591,8 +95738,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 174,
-          "end_line": 206,
+          "start_line": 200,
+          "end_line": 236,
           "tags": {
             "PURPOSE": "Execute compliance run for candidate with optional manifest fallback.",
             "PRE": "Candidate exists and trusted snapshots are configured.",
@@ -94611,8 +95758,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 209,
-          "end_line": 234,
+          "start_line": 239,
+          "end_line": 268,
           "tags": {
             "PURPOSE": "Read run status by run id.",
             "PRE": "Run exists.",
@@ -94631,8 +95778,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 237,
-          "end_line": 262,
+          "start_line": 271,
+          "end_line": 298,
           "tags": {
             "PURPOSE": "Serialize domain models for CLI JSON output across SQLAlchemy/Pydantic variants.",
             "PRE": "value is serializable model or primitive object.",
@@ -94651,8 +95798,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 265,
-          "end_line": 285,
+          "start_line": 301,
+          "end_line": 325,
           "tags": {
             "PURPOSE": "Read immutable report by run id.",
             "PRE": "Run and report exist.",
@@ -94671,8 +95818,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 288,
-          "end_line": 304,
+          "start_line": 328,
+          "end_line": 350,
           "tags": {
             "PURPOSE": "Read run violations by run id.",
             "PRE": "Run exists.",
@@ -94691,8 +95838,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 307,
-          "end_line": 329,
+          "start_line": 353,
+          "end_line": 381,
           "tags": {
             "PURPOSE": "Approve candidate based on immutable PASSED report.",
             "PRE": "Candidate and report exist; report is PASSED.",
@@ -94711,8 +95858,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 332,
-          "end_line": 354,
+          "start_line": 384,
+          "end_line": 412,
           "tags": {
             "PURPOSE": "Reject candidate without mutating compliance evidence.",
             "PRE": "Candidate and report exist.",
@@ -94731,8 +95878,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 357,
-          "end_line": 380,
+          "start_line": 415,
+          "end_line": 440,
           "tags": {
             "PURPOSE": "Publish approved candidate to target channel.",
             "PRE": "Candidate is approved and report belongs to candidate.",
@@ -94751,8 +95898,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 383,
-          "end_line": 404,
+          "start_line": 443,
+          "end_line": 466,
           "tags": {
             "PURPOSE": "Revoke active publication record.",
             "PRE": "Publication id exists and is ACTIVE.",
@@ -94771,8 +95918,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 407,
-          "end_line": 438,
+          "start_line": 469,
+          "end_line": 502,
           "tags": {
             "PURPOSE": "CLI entrypoint for clean release commands."
           },
@@ -94789,8 +95936,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 242,
-          "end_line": 242,
+          "start_line": 276,
+          "end_line": 276,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -94813,7 +95960,7 @@
             "line_number": 1
           },
           {
-            "message": "Fractal limit warning: Module length is 444 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 508 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -94996,12 +96143,12 @@
       }
     },
     {
-      "name": "backend.src.scripts.create_admin",
+      "name": "CreateAdminScript",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 94,
+      "end_line": 99,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "admin, setup, user, auth, cli",
@@ -95012,15 +96159,15 @@
       "relations": [
         {
           "type": "USES",
-          "target": "backend.src.core.auth.security"
+          "target": "AuthSecurityModule"
         },
         {
           "type": "USES",
-          "target": "backend.src.core.database"
+          "target": "DatabaseModule"
         },
         {
           "type": "USES",
-          "target": "backend.src.models.auth"
+          "target": "AuthModels"
         }
       ],
       "children": [
@@ -95029,8 +96176,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 27,
-          "end_line": 77,
+          "start_line": 28,
+          "end_line": 82,
           "tags": {
             "PURPOSE": "Creates an admin user and necessary roles/permissions.",
             "PRE": "username and password provided via CLI.",
@@ -95069,7 +96216,7 @@
       }
     },
     {
-      "name": "src.scripts",
+      "name": "ScriptsPackage",
       "type": "Package",
       "complexity": 1,
       "tier": "TRIVIAL",
@@ -95087,12 +96234,12 @@
       }
     },
     {
-      "name": "backend.src.schemas.health",
+      "name": "HealthSchemas",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 35,
+      "end_line": 41,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "health, schemas, pydantic",
@@ -95106,8 +96253,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 11,
-          "end_line": 23,
+          "start_line": 12,
+          "end_line": 26,
           "tags": {
             "PURPOSE": "Represents the latest health status of a single dashboard."
           },
@@ -95124,8 +96271,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 25,
-          "end_line": 33,
+          "start_line": 29,
+          "end_line": 39,
           "tags": {
             "PURPOSE": "Aggregated health summary for all dashboards."
           },
@@ -95156,7 +96303,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 364,
+      "end_line": 419,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "dataset_review, schemas, pydantic, session, profile, findings",
@@ -95175,8 +96322,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 49,
-          "end_line": 57,
+          "start_line": 50,
+          "end_line": 60,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95191,8 +96338,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 59,
-          "end_line": 81,
+          "start_line": 63,
+          "end_line": 87,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95207,8 +96354,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 83,
-          "end_line": 100,
+          "start_line": 90,
+          "end_line": 109,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95223,8 +96370,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 102,
-          "end_line": 117,
+          "start_line": 112,
+          "end_line": 129,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95239,8 +96386,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 119,
-          "end_line": 135,
+          "start_line": 132,
+          "end_line": 150,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95255,8 +96402,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 137,
-          "end_line": 161,
+          "start_line": 153,
+          "end_line": 180,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95271,8 +96418,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 163,
-          "end_line": 181,
+          "start_line": 183,
+          "end_line": 204,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95287,8 +96434,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 183,
-          "end_line": 198,
+          "start_line": 207,
+          "end_line": 224,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95303,8 +96450,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 200,
-          "end_line": 220,
+          "start_line": 227,
+          "end_line": 250,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95319,8 +96466,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 222,
-          "end_line": 233,
+          "start_line": 253,
+          "end_line": 266,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95335,8 +96482,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 235,
-          "end_line": 248,
+          "start_line": 269,
+          "end_line": 284,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95351,8 +96498,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 250,
-          "end_line": 267,
+          "start_line": 287,
+          "end_line": 306,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95367,8 +96514,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 269,
-          "end_line": 285,
+          "start_line": 309,
+          "end_line": 327,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95383,8 +96530,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 287,
-          "end_line": 302,
+          "start_line": 330,
+          "end_line": 348,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95399,8 +96546,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 304,
-          "end_line": 323,
+          "start_line": 351,
+          "end_line": 373,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95415,8 +96562,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 325,
-          "end_line": 344,
+          "start_line": 376,
+          "end_line": 399,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95431,8 +96578,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 346,
-          "end_line": 362,
+          "start_line": 402,
+          "end_line": 417,
           "tags": {},
           "relations": [],
           "children": [],
@@ -95447,7 +96594,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 364 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 419 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -95456,12 +96603,12 @@
       }
     },
     {
-      "name": "backend.src.schemas.settings",
+      "name": "SettingsSchemas",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 68,
+      "end_line": 96,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "settings, schemas, pydantic, validation",
@@ -95475,8 +96622,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 11,
-          "end_line": 16,
+          "start_line": 12,
+          "end_line": 23,
           "tags": {
             "PURPOSE": "Structured notification channel definition for policy-level custom routing."
           },
@@ -95493,8 +96640,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 18,
-          "end_line": 34,
+          "start_line": 26,
+          "end_line": 53,
           "tags": {
             "PURPOSE": "Base schema for validation policy data."
           },
@@ -95511,8 +96658,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 36,
-          "end_line": 40,
+          "start_line": 56,
+          "end_line": 62,
           "tags": {
             "PURPOSE": "Schema for creating a new validation policy."
           },
@@ -95529,8 +96676,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 42,
-          "end_line": 55,
+          "start_line": 65,
+          "end_line": 80,
           "tags": {
             "PURPOSE": "Schema for updating an existing validation policy."
           },
@@ -95547,8 +96694,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 57,
-          "end_line": 66,
+          "start_line": 83,
+          "end_line": 94,
           "tags": {
             "PURPOSE": "Schema for validation policy response data."
           },
@@ -95574,12 +96721,12 @@
       }
     },
     {
-      "name": "backend.src.schemas.auth",
+      "name": "AuthSchemas",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 128,
+      "end_line": 164,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "auth, schemas, pydantic, user, token",
@@ -95599,8 +96746,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 17,
-          "end_line": 23,
+          "start_line": 18,
+          "end_line": 26,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Represents a JWT access token response."
@@ -95618,8 +96765,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 25,
-          "end_line": 31,
+          "start_line": 29,
+          "end_line": 37,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Represents the data encoded in a JWT token."
@@ -95637,8 +96784,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 33,
-          "end_line": 43,
+          "start_line": 40,
+          "end_line": 52,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Represents a permission in API responses."
@@ -95656,8 +96803,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 45,
-          "end_line": 55,
+          "start_line": 55,
+          "end_line": 67,
           "tags": {
             "PURPOSE": "Represents a role in API responses."
           },
@@ -95669,72 +96816,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 45
+                "line_number": 55
               }
             ],
             "score": 0.0
@@ -95745,8 +96892,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 57,
-          "end_line": 63,
+          "start_line": 70,
+          "end_line": 78,
           "tags": {
             "PURPOSE": "Schema for creating a new role."
           },
@@ -95758,72 +96905,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 57
+                "line_number": 70
               }
             ],
             "score": 0.0
@@ -95834,8 +96981,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 65,
-          "end_line": 71,
+          "start_line": 81,
+          "end_line": 89,
           "tags": {
             "PURPOSE": "Schema for updating an existing role."
           },
@@ -95847,72 +96994,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 65
+                "line_number": 81
               }
             ],
             "score": 0.0
@@ -95923,8 +97070,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 73,
-          "end_line": 82,
+          "start_line": 92,
+          "end_line": 103,
           "tags": {
             "PURPOSE": "Represents an AD Group to Role mapping in API responses."
           },
@@ -95936,72 +97083,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 73
+                "line_number": 92
               }
             ],
             "score": 0.0
@@ -96012,8 +97159,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 84,
-          "end_line": 89,
+          "start_line": 106,
+          "end_line": 113,
           "tags": {
             "PURPOSE": "Schema for creating an AD Group mapping."
           },
@@ -96025,72 +97172,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 84
+                "line_number": 106
               }
             ],
             "score": 0.0
@@ -96101,8 +97248,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 91,
-          "end_line": 97,
+          "start_line": 116,
+          "end_line": 124,
           "tags": {
             "PURPOSE": "Base schema for user data."
           },
@@ -96114,72 +97261,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 91
+                "line_number": 116
               }
             ],
             "score": 0.0
@@ -96190,8 +97337,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 99,
-          "end_line": 104,
+          "start_line": 127,
+          "end_line": 134,
           "tags": {
             "PURPOSE": "Schema for creating a new user."
           },
@@ -96203,72 +97350,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 99
+                "line_number": 127
               }
             ],
             "score": 0.0
@@ -96279,8 +97426,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 106,
-          "end_line": 113,
+          "start_line": 137,
+          "end_line": 146,
           "tags": {
             "PURPOSE": "Schema for updating an existing user."
           },
@@ -96292,72 +97439,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 106
+                "line_number": 137
               }
             ],
             "score": 0.0
@@ -96368,8 +97515,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 115,
-          "end_line": 126,
+          "start_line": 149,
+          "end_line": 162,
           "tags": {
             "PURPOSE": "Schema for user data in API responses."
           },
@@ -96381,72 +97528,72 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 115
+                "line_number": 149
               }
             ],
             "score": 0.0
@@ -96460,12 +97607,12 @@
       }
     },
     {
-      "name": "backend.src.schemas.profile",
+      "name": "ProfileSchemas",
       "type": "Module",
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 180,
+      "end_line": 196,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "profile, schemas, pydantic, preferences, superset, lookup, security, git, ux",
@@ -96486,7 +97633,7 @@
           "complexity": 3,
           "tier": "STANDARD",
           "start_line": 18,
-          "end_line": 24,
+          "end_line": 26,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Represents one permission badge state for profile read-only security view."
@@ -96515,8 +97662,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 27,
-          "end_line": 37,
+          "start_line": 29,
+          "end_line": 41,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Read-only security and access snapshot for current user."
@@ -96529,12 +97676,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 27
+                "line_number": 29
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 27
+                "line_number": 29
               }
             ],
             "score": 0.5499999999999999
@@ -96545,8 +97692,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 40,
-          "end_line": 68,
+          "start_line": 44,
+          "end_line": 74,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Represents persisted profile preference for a single authenticated user."
@@ -96559,12 +97706,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 40
+                "line_number": 44
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 40
+                "line_number": 44
               }
             ],
             "score": 0.5499999999999999
@@ -96575,8 +97722,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 71,
-          "end_line": 127,
+          "start_line": 77,
+          "end_line": 135,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Request payload for updating current user's profile settings."
@@ -96589,12 +97736,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 71
+                "line_number": 77
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 71
+                "line_number": 77
               }
             ],
             "score": 0.5499999999999999
@@ -96605,8 +97752,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 130,
-          "end_line": 139,
+          "start_line": 138,
+          "end_line": 149,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Response envelope for profile preference read/update endpoints."
@@ -96619,12 +97766,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 130
+                "line_number": 138
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 130
+                "line_number": 138
               }
             ],
             "score": 0.5499999999999999
@@ -96635,8 +97782,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 142,
-          "end_line": 152,
+          "start_line": 152,
+          "end_line": 164,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Query contract for Superset account lookup by selected environment."
@@ -96649,12 +97796,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 142
+                "line_number": 152
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 142
+                "line_number": 152
               }
             ],
             "score": 0.5499999999999999
@@ -96665,8 +97812,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 155,
-          "end_line": 164,
+          "start_line": 167,
+          "end_line": 178,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Canonical account candidate projected from Superset users payload."
@@ -96679,12 +97826,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 155
+                "line_number": 167
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 155
+                "line_number": 167
               }
             ],
             "score": 0.5499999999999999
@@ -96695,8 +97842,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 167,
-          "end_line": 178,
+          "start_line": 181,
+          "end_line": 194,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Response envelope for Superset account lookup (success or degraded mode)."
@@ -96709,12 +97856,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 167
+                "line_number": 181
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 167
+                "line_number": 181
               }
             ],
             "score": 0.5499999999999999
@@ -96728,7 +97875,7 @@
       }
     },
     {
-      "name": "src.schemas",
+      "name": "SchemasPackage",
       "type": "Package",
       "complexity": 1,
       "tier": "TRIVIAL",
@@ -99843,7 +100990,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 552,
+      "end_line": 638,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "database, postgresql, sqlalchemy, session, persistence",
@@ -100238,13 +101385,44 @@
             "score": 0.85
           }
         },
+        {
+          "name": "_ensure_dataset_review_session_columns",
+          "type": "Function",
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 470,
+          "end_line": 551,
+          "tags": {
+            "COMPLEXITY": "4",
+            "PURPOSE": "Apply additive schema upgrades for dataset review persistence required by optimistic-lock and recovery metadata semantics.",
+            "PRE": "bind_engine points to the application database where dataset review tables are stored.",
+            "POST": "Missing additive columns across legacy dataset review tables are created without removing existing data.",
+            "SIDE_EFFECT": "Executes ALTER TABLE statements against dataset review tables in the application database."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "DatasetReviewSession"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ImportedFilter"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 0.9400000000000001
+          }
+        },
         {
           "name": "init_db",
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 470,
-          "end_line": 492,
+          "start_line": 554,
+          "end_line": 578,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Initializes the database by creating all tables.",
@@ -100260,6 +101438,10 @@
             {
               "type": "CALLS",
               "target": "_ensure_filter_source_enum_values"
+            },
+            {
+              "type": "CALLS",
+              "target": "_ensure_dataset_review_session_columns"
             }
           ],
           "children": [],
@@ -100274,8 +101456,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 495,
-          "end_line": 511,
+          "start_line": 581,
+          "end_line": 597,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Dependency for getting a database session.",
@@ -100301,8 +101483,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 514,
-          "end_line": 530,
+          "start_line": 600,
+          "end_line": 616,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Dependency for getting a tasks database session.",
@@ -100328,8 +101510,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 533,
-          "end_line": 550,
+          "start_line": 619,
+          "end_line": 636,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Dependency for getting an authentication database session.",
@@ -100375,7 +101557,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 552 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 638 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -102603,9 +103785,8 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 164,
+      "end_line": 163,
       "tags": {
-        "TIER": "CRITICAL",
         "COMPLEXITY": "5",
         "SEMANTICS": "auth, repository, database, user, role, permission",
         "PURPOSE": "Data access layer for authentication and user preference entities.",
@@ -102648,8 +103829,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 28,
-          "end_line": 162,
+          "start_line": 27,
+          "end_line": 161,
           "tags": {
             "PURPOSE": "Initialize repository with database session.",
             "PRE": "Database session is bound.",
@@ -102668,8 +103849,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 39,
-              "end_line": 51,
+              "start_line": 38,
+              "end_line": 50,
               "tags": {
                 "PURPOSE": "Retrieve user by UUID.",
                 "PRE": "user_id is a valid UUID string.",
@@ -102693,8 +103874,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 53,
-              "end_line": 65,
+              "start_line": 52,
+              "end_line": 64,
               "tags": {
                 "PURPOSE": "Retrieve user by username.",
                 "PRE": "username is a non-empty string.",
@@ -102718,8 +103899,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 67,
-              "end_line": 80,
+              "start_line": 66,
+              "end_line": 79,
               "tags": {
                 "PURPOSE": "Retrieve role by UUID with permissions preloaded."
               },
@@ -102745,8 +103926,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 82,
-              "end_line": 89,
+              "start_line": 81,
+              "end_line": 88,
               "tags": {
                 "PURPOSE": "Retrieve role by unique name."
               },
@@ -102768,8 +103949,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 91,
-              "end_line": 100,
+              "start_line": 90,
+              "end_line": 99,
               "tags": {
                 "PURPOSE": "Retrieve permission by UUID."
               },
@@ -102791,8 +103972,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 102,
-              "end_line": 115,
+              "start_line": 101,
+              "end_line": 114,
               "tags": {
                 "PURPOSE": "Retrieve permission by resource and action tuple."
               },
@@ -102814,8 +103995,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 117,
-              "end_line": 124,
+              "start_line": 116,
+              "end_line": 123,
               "tags": {
                 "PURPOSE": "List all system permissions."
               },
@@ -102837,8 +104018,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 126,
-              "end_line": 139,
+              "start_line": 125,
+              "end_line": 138,
               "tags": {
                 "PURPOSE": "Retrieve dashboard filters/preferences for a user."
               },
@@ -102860,8 +104041,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 141,
-              "end_line": 159,
+              "start_line": 140,
+              "end_line": 158,
               "tags": {
                 "PURPOSE": "Retrieve roles that match a list of AD group names.",
                 "PRE": "groups is a list of strings representing AD group identifiers.",
@@ -102891,32 +104072,32 @@
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 28
+                "line_number": 27
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 28
+                "line_number": 27
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 28
+                "line_number": 27
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 28
+                "line_number": 27
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 28
+                "line_number": 27
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 28
+                "line_number": 27
               }
             ],
             "score": 0.0
@@ -102927,8 +104108,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 36,
-          "end_line": 36,
+          "start_line": 35,
+          "end_line": 35,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103324,7 +104505,7 @@
       "complexity": 4,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 1294,
+      "end_line": 1397,
       "tags": {
         "COMPLEXITY": "4",
         "SEMANTICS": "dataset_review, superset, link_parsing, context_recovery, partial_recovery",
@@ -103366,13 +104547,70 @@
             "score": 1.0
           }
         },
+        {
+          "name": "mask_pii_value",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 43,
+          "end_line": 68,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Redact likely sensitive identifiers while preserving structural hints for assistant-facing dataset-review context."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "sanitize_imported_filter_for_assistant",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 71,
+          "end_line": 86,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Build assistant-safe imported-filter payload with raw-value redaction metadata when sensitive tokens are detected."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_mask_sensitive_text",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 89,
+          "end_line": 129,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Redact likely PII substrings from one string while preserving non-sensitive delimiters and token shape."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "SupersetParsedContext",
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 32,
-          "end_line": 49,
+          "start_line": 132,
+          "end_line": 150,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Normalized output of Superset link parsing for session intake and recovery."
@@ -103390,8 +104628,8 @@
           "type": "Class",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 52,
-          "end_line": 1292,
+          "start_line": 153,
+          "end_line": 1395,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Parse supported Superset URLs and recover canonical dataset/dashboard references for review-session intake.",
@@ -103411,8 +104649,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 60,
-              "end_line": 69,
+              "start_line": 161,
+              "end_line": 170,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Bind extractor to one Superset environment and client instance."
@@ -103430,8 +104668,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 71,
-              "end_line": 367,
+              "start_line": 172,
+              "end_line": 470,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Extract candidate identifiers and query state from supported Superset URLs.",
@@ -103458,8 +104696,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 369,
-              "end_line": 603,
+              "start_line": 472,
+              "end_line": 706,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Build imported filter entries from URL state and Superset-side saved context.",
@@ -103486,8 +104724,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 605,
-              "end_line": 696,
+              "start_line": 708,
+              "end_line": 799,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Detect runtime variables and Jinja references from dataset query-bearing fields.",
@@ -103514,8 +104752,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 698,
-              "end_line": 714,
+              "start_line": 801,
+              "end_line": 817,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Summarize recovered, partial, and unresolved context for session state and UX."
@@ -103533,8 +104771,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 716,
-              "end_line": 737,
+              "start_line": 819,
+              "end_line": 840,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Extract a numeric identifier from a REST-like Superset URL path."
@@ -103552,8 +104790,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 739,
-              "end_line": 758,
+              "start_line": 842,
+              "end_line": 861,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Extract a dashboard id-or-slug reference from a Superset URL path."
@@ -103571,8 +104809,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 760,
-              "end_line": 780,
+              "start_line": 863,
+              "end_line": 883,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Extract a dashboard permalink key from a Superset URL path."
@@ -103590,8 +104828,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 782,
-              "end_line": 791,
+              "start_line": 885,
+              "end_line": 894,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Extract a dashboard identifier from returned permalink state when present."
@@ -103609,8 +104847,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 793,
-              "end_line": 802,
+              "start_line": 896,
+              "end_line": 905,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Extract a chart identifier from returned permalink state when dashboard id is absent."
@@ -103628,8 +104866,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 804,
-              "end_line": 829,
+              "start_line": 907,
+              "end_line": 932,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Recursively search nested dict/list payloads for the first numeric value under a candidate key set."
@@ -103652,8 +104890,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 831,
-              "end_line": 871,
+              "start_line": 934,
+              "end_line": 974,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Recover a dataset binding from resolved dashboard context while preserving explicit unresolved markers."
@@ -103676,8 +104914,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 873,
-              "end_line": 895,
+              "start_line": 976,
+              "end_line": 998,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Decode query-string structures used by Superset URL state transport."
@@ -103695,8 +104933,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 897,
-              "end_line": 1129,
+              "start_line": 1000,
+              "end_line": 1232,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Normalize imported filters from decoded query state without fabricating missing values."
@@ -103714,8 +104952,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 1131,
-              "end_line": 1172,
+              "start_line": 1234,
+              "end_line": 1275,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Normalize one imported-filter payload with explicit provenance and confirmation state."
@@ -103733,8 +104971,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 1174,
-              "end_line": 1216,
+              "start_line": 1277,
+              "end_line": 1319,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Collect SQL and expression-bearing dataset fields for deterministic template-variable discovery."
@@ -103757,8 +104995,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 1218,
-              "end_line": 1249,
+              "start_line": 1321,
+              "end_line": 1352,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Append one deduplicated template-variable descriptor."
@@ -103776,8 +105014,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 1251,
-              "end_line": 1263,
+              "start_line": 1354,
+              "end_line": 1366,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Extract a deterministic primary identifier from a Jinja expression without executing it."
@@ -103795,8 +105033,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 1265,
-              "end_line": 1289,
+              "start_line": 1368,
+              "end_line": 1392,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Normalize literal default fragments from template helper calls into JSON-safe values."
@@ -103816,13 +105054,89 @@
             "score": 0.9400000000000001
           }
         },
+        {
+          "name": "_replace_email",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 96,
+          "end_line": 96,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_replace_uuid",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 102,
+          "end_line": 102,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_replace_long_digits",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 108,
+          "end_line": 108,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_replace_mixed_identifier",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 114,
+          "end_line": 114,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "__init__",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 63,
-          "end_line": 63,
+          "start_line": 164,
+          "end_line": 164,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103840,8 +105154,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 79,
-          "end_line": 79,
+          "start_line": 180,
+          "end_line": 180,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103859,8 +105173,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 377,
-          "end_line": 377,
+          "start_line": 480,
+          "end_line": 480,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103878,8 +105192,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 386,
-          "end_line": 386,
+          "start_line": 489,
+          "end_line": 489,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103897,8 +105211,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 613,
-          "end_line": 613,
+          "start_line": 716,
+          "end_line": 716,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103916,8 +105230,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 701,
-          "end_line": 701,
+          "start_line": 804,
+          "end_line": 804,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103935,8 +105249,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 719,
-          "end_line": 719,
+          "start_line": 822,
+          "end_line": 822,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103954,8 +105268,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 742,
-          "end_line": 742,
+          "start_line": 845,
+          "end_line": 845,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103973,8 +105287,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 763,
-          "end_line": 763,
+          "start_line": 866,
+          "end_line": 866,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -103992,8 +105306,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 785,
-          "end_line": 785,
+          "start_line": 888,
+          "end_line": 888,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104011,8 +105325,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 796,
-          "end_line": 796,
+          "start_line": 899,
+          "end_line": 899,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104030,8 +105344,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 808,
-          "end_line": 808,
+          "start_line": 911,
+          "end_line": 911,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104049,8 +105363,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 835,
-          "end_line": 835,
+          "start_line": 938,
+          "end_line": 938,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104068,8 +105382,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 876,
-          "end_line": 876,
+          "start_line": 979,
+          "end_line": 979,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104087,8 +105401,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 900,
-          "end_line": 900,
+          "start_line": 1003,
+          "end_line": 1003,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104106,8 +105420,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1134,
-          "end_line": 1134,
+          "start_line": 1237,
+          "end_line": 1237,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104125,8 +105439,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1178,
-          "end_line": 1178,
+          "start_line": 1281,
+          "end_line": 1281,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104144,8 +105458,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1183,
-          "end_line": 1183,
+          "start_line": 1286,
+          "end_line": 1286,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104163,8 +105477,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1221,
-          "end_line": 1221,
+          "start_line": 1324,
+          "end_line": 1324,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104182,8 +105496,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1254,
-          "end_line": 1254,
+          "start_line": 1357,
+          "end_line": 1357,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104201,8 +105515,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1268,
-          "end_line": 1268,
+          "start_line": 1371,
+          "end_line": 1371,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -104220,7 +105534,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 1294 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 1397 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -106749,8 +108063,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 30,
-          "end_line": 40,
+          "start_line": 31,
+          "end_line": 43,
           "tags": {},
           "relations": [
             {
@@ -106770,7 +108084,7 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 43,
+          "start_line": 46,
           "end_line": null,
           "tags": {
             "PURPOSE": "Extract native filters from a permalink key."
@@ -106787,7 +108101,7 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 90,
+              "start_line": 95,
               "end_line": null,
               "tags": {
                 "PURPOSE": "Handle permalink response without result wrapper."
@@ -106804,7 +108118,7 @@
                   "type": "Function",
                   "complexity": 1,
                   "tier": "TRIVIAL",
-                  "start_line": 116,
+                  "start_line": 123,
                   "end_line": null,
                   "tags": {
                     "PURPOSE": "Extract native filters from a native_filters_key."
@@ -106821,7 +108135,7 @@
                       "type": "Function",
                       "complexity": 1,
                       "tier": "TRIVIAL",
-                      "start_line": 147,
+                      "start_line": 162,
                       "end_line": null,
                       "tags": {
                         "PURPOSE": "Handle single filter format in native filter state."
@@ -106838,7 +108152,7 @@
                           "type": "Function",
                           "complexity": 1,
                           "tier": "TRIVIAL",
-                          "start_line": 172,
+                          "start_line": 196,
                           "end_line": null,
                           "tags": {
                             "PURPOSE": "Handle filter state value as dict instead of JSON string."
@@ -106855,7 +108169,7 @@
                               "type": "Function",
                               "complexity": 1,
                               "tier": "TRIVIAL",
-                              "start_line": 197,
+                              "start_line": 223,
                               "end_line": null,
                               "tags": {
                                 "PURPOSE": "Parse permalink URL format."
@@ -106872,7 +108186,7 @@
                                   "type": "Function",
                                   "complexity": 1,
                                   "tier": "TRIVIAL",
-                                  "start_line": 215,
+                                  "start_line": 243,
                                   "end_line": null,
                                   "tags": {
                                     "PURPOSE": "Parse native_filters_key URL format with numeric dashboard ID."
@@ -106889,7 +108203,7 @@
                                       "type": "Function",
                                       "complexity": 1,
                                       "tier": "TRIVIAL",
-                                      "start_line": 234,
+                                      "start_line": 268,
                                       "end_line": null,
                                       "tags": {
                                         "PURPOSE": "Parse native_filters_key URL format when dashboard reference is a slug, not a numeric ID."
@@ -106906,7 +108220,7 @@
                                           "type": "Function",
                                           "complexity": 1,
                                           "tier": "TRIVIAL",
-                                          "start_line": 261,
+                                          "start_line": 301,
                                           "end_line": null,
                                           "tags": {
                                             "PURPOSE": "Gracefully handle slug resolution failure for native_filters_key URL."
@@ -106923,7 +108237,7 @@
                                               "type": "Function",
                                               "complexity": 1,
                                               "tier": "TRIVIAL",
-                                              "start_line": 277,
+                                              "start_line": 319,
                                               "end_line": null,
                                               "tags": {
                                                 "PURPOSE": "Parse native_filters direct query param."
@@ -106940,7 +108254,7 @@
                                                   "type": "Function",
                                                   "complexity": 1,
                                                   "tier": "TRIVIAL",
-                                                  "start_line": 293,
+                                                  "start_line": 337,
                                                   "end_line": null,
                                                   "tags": {
                                                     "PURPOSE": "Return empty result when no filters present."
@@ -106957,7 +108271,7 @@
                                                       "type": "Function",
                                                       "complexity": 1,
                                                       "tier": "TRIVIAL",
-                                                      "start_line": 308,
+                                                      "start_line": 354,
                                                       "end_line": null,
                                                       "tags": {
                                                         "PURPOSE": "Test ExtraFormDataMerge correctly merges dictionaries."
@@ -106974,7 +108288,7 @@
                                                           "type": "Function",
                                                           "complexity": 1,
                                                           "tier": "TRIVIAL",
-                                                          "start_line": 344,
+                                                          "start_line": 392,
                                                           "end_line": null,
                                                           "tags": {
                                                             "PURPOSE": "Test FilterState Pydantic model."
@@ -106991,7 +108305,7 @@
                                                               "type": "Function",
                                                               "complexity": 1,
                                                               "tier": "TRIVIAL",
-                                                              "start_line": 360,
+                                                              "start_line": 410,
                                                               "end_line": null,
                                                               "tags": {
                                                                 "PURPOSE": "Test ParsedNativeFilters Pydantic model."
@@ -107008,7 +108322,7 @@
                                                                   "type": "Function",
                                                                   "complexity": 1,
                                                                   "tier": "TRIVIAL",
-                                                                  "start_line": 377,
+                                                                  "start_line": 429,
                                                                   "end_line": null,
                                                                   "tags": {
                                                                     "PURPOSE": "Test ParsedNativeFilters with no filters."
@@ -107025,7 +108339,7 @@
                                                                       "type": "Function",
                                                                       "complexity": 1,
                                                                       "tier": "TRIVIAL",
-                                                                      "start_line": 388,
+                                                                      "start_line": 442,
                                                                       "end_line": null,
                                                                       "tags": {
                                                                         "PURPOSE": "Test NativeFilterDataMask model."
@@ -107042,8 +108356,8 @@
                                                                           "type": "Function",
                                                                           "complexity": 1,
                                                                           "tier": "TRIVIAL",
-                                                                          "start_line": 405,
-                                                                          "end_line": 461,
+                                                                          "start_line": 463,
+                                                                          "end_line": 527,
                                                                           "tags": {
                                                                             "PURPOSE": "Reconcile raw native filter ids from state to canonical metadata filter names."
                                                                           },
@@ -107065,8 +108379,8 @@
                                                                           "type": "Function",
                                                                           "complexity": 1,
                                                                           "tier": "TRIVIAL",
-                                                                          "start_line": 464,
-                                                                          "end_line": 517,
+                                                                          "start_line": 530,
+                                                                          "end_line": 585,
                                                                           "tags": {
                                                                             "PURPOSE": "Collapse raw-id state entries and metadata entries into one canonical filter."
                                                                           },
@@ -107088,8 +108402,8 @@
                                                                           "type": "Function",
                                                                           "complexity": 1,
                                                                           "tier": "TRIVIAL",
-                                                                          "start_line": 520,
-                                                                          "end_line": 569,
+                                                                          "start_line": 588,
+                                                                          "end_line": 642,
                                                                           "tags": {
                                                                             "PURPOSE": "Preserve unmatched raw native filter ids as fallback diagnostics when metadata mapping is unavailable."
                                                                           },
@@ -107111,8 +108425,8 @@
                                                                           "type": "Function",
                                                                           "complexity": 1,
                                                                           "tier": "TRIVIAL",
-                                                                          "start_line": 572,
-                                                                          "end_line": 612,
+                                                                          "start_line": 645,
+                                                                          "end_line": 687,
                                                                           "tags": {
                                                                             "PURPOSE": "Recovered native filter state should preserve exact Superset clause payload and time extras for preview compilation."
                                                                           },
@@ -107128,95 +108442,118 @@
                                                                             "issues": [],
                                                                             "score": 1.0
                                                                           }
+                                                                        },
+                                                                        {
+                                                                          "name": "test_sanitize_imported_filter_for_assistant_masks_sensitive_raw_values",
+                                                                          "type": "Function",
+                                                                          "complexity": 1,
+                                                                          "tier": "TRIVIAL",
+                                                                          "start_line": 690,
+                                                                          "end_line": 708,
+                                                                          "tags": {
+                                                                            "PURPOSE": "Assistant-facing imported-filter payload should redact likely PII while preserving structure metadata."
+                                                                          },
+                                                                          "relations": [
+                                                                            {
+                                                                              "type": "BINDS_TO",
+                                                                              "target": "NativeFilterExtractionTests"
+                                                                            }
+                                                                          ],
+                                                                          "children": [],
+                                                                          "compliance": {
+                                                                            "valid": true,
+                                                                            "issues": [],
+                                                                            "score": 1.0
+                                                                          }
                                                                         }
                                                                       ],
                                                                       "compliance": {
                                                                         "valid": false,
                                                                         "issues": [
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           },
                                                                           {
-                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 388",
+                                                                            "message": "Unclosed Anchor: [DEF:test_native_filter_data_mask_model:Function] started at line 442",
                                                                             "severity": "ERROR",
-                                                                            "line_number": 388
+                                                                            "line_number": 442
                                                                           }
                                                                         ],
                                                                         "score": 0.0
@@ -107227,84 +108564,84 @@
                                                                     "valid": false,
                                                                     "issues": [
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       },
                                                                       {
-                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 377",
+                                                                        "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_empty:Function] started at line 429",
                                                                         "severity": "ERROR",
-                                                                        "line_number": 377
+                                                                        "line_number": 429
                                                                       }
                                                                     ],
                                                                     "score": 0.0
@@ -107315,79 +108652,79 @@
                                                                 "valid": false,
                                                                 "issues": [
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   },
                                                                   {
-                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 360",
+                                                                    "message": "Unclosed Anchor: [DEF:test_parsed_native_filters_model:Function] started at line 410",
                                                                     "severity": "ERROR",
-                                                                    "line_number": 360
+                                                                    "line_number": 410
                                                                   }
                                                                 ],
                                                                 "score": 0.0
@@ -107398,74 +108735,74 @@
                                                             "valid": false,
                                                             "issues": [
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               },
                                                               {
-                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 344",
+                                                                "message": "Unclosed Anchor: [DEF:test_filter_state_model:Function] started at line 392",
                                                                 "severity": "ERROR",
-                                                                "line_number": 344
+                                                                "line_number": 392
                                                               }
                                                             ],
                                                             "score": 0.0
@@ -107476,69 +108813,69 @@
                                                         "valid": false,
                                                         "issues": [
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           },
                                                           {
-                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 308",
+                                                            "message": "Unclosed Anchor: [DEF:test_extra_form_data_merge:Function] started at line 354",
                                                             "severity": "ERROR",
-                                                            "line_number": 308
+                                                            "line_number": 354
                                                           }
                                                         ],
                                                         "score": 0.0
@@ -107549,64 +108886,64 @@
                                                     "valid": false,
                                                     "issues": [
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       },
                                                       {
-                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 293",
+                                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_no_filters:Function] started at line 337",
                                                         "severity": "ERROR",
-                                                        "line_number": 293
+                                                        "line_number": 337
                                                       }
                                                     ],
                                                     "score": 0.0
@@ -107617,59 +108954,59 @@
                                                 "valid": false,
                                                 "issues": [
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   },
                                                   {
-                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 277",
+                                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_filters_direct:Function] started at line 319",
                                                     "severity": "ERROR",
-                                                    "line_number": 277
+                                                    "line_number": 319
                                                   }
                                                 ],
                                                 "score": 0.0
@@ -107680,54 +109017,54 @@
                                             "valid": false,
                                             "issues": [
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               },
                                               {
-                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 261",
+                                                "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug_resolution_fails:Function] started at line 301",
                                                 "severity": "ERROR",
-                                                "line_number": 261
+                                                "line_number": 301
                                               }
                                             ],
                                             "score": 0.0
@@ -107738,49 +109075,49 @@
                                         "valid": false,
                                         "issues": [
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           },
                                           {
-                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 234",
+                                            "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key_slug:Function] started at line 268",
                                             "severity": "ERROR",
-                                            "line_number": 234
+                                            "line_number": 268
                                           }
                                         ],
                                         "score": 0.0
@@ -107791,44 +109128,44 @@
                                     "valid": false,
                                     "issues": [
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       },
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       },
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       },
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       },
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       },
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       },
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       },
                                       {
-                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 215",
+                                        "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_native_key:Function] started at line 243",
                                         "severity": "ERROR",
-                                        "line_number": 215
+                                        "line_number": 243
                                       }
                                     ],
                                     "score": 0.0
@@ -107839,39 +109176,39 @@
                                 "valid": false,
                                 "issues": [
                                   {
-                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 197",
+                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 223",
                                     "severity": "ERROR",
-                                    "line_number": 197
+                                    "line_number": 223
                                   },
                                   {
-                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 197",
+                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 223",
                                     "severity": "ERROR",
-                                    "line_number": 197
+                                    "line_number": 223
                                   },
                                   {
-                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 197",
+                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 223",
                                     "severity": "ERROR",
-                                    "line_number": 197
+                                    "line_number": 223
                                   },
                                   {
-                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 197",
+                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 223",
                                     "severity": "ERROR",
-                                    "line_number": 197
+                                    "line_number": 223
                                   },
                                   {
-                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 197",
+                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 223",
                                     "severity": "ERROR",
-                                    "line_number": 197
+                                    "line_number": 223
                                   },
                                   {
-                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 197",
+                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 223",
                                     "severity": "ERROR",
-                                    "line_number": 197
+                                    "line_number": 223
                                   },
                                   {
-                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 197",
+                                    "message": "Unclosed Anchor: [DEF:test_parse_dashboard_url_for_filters_permalink:Function] started at line 223",
                                     "severity": "ERROR",
-                                    "line_number": 197
+                                    "line_number": 223
                                   }
                                 ],
                                 "score": 0.0
@@ -107882,34 +109219,34 @@
                             "valid": false,
                             "issues": [
                               {
-                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 172",
+                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 196",
                                 "severity": "ERROR",
-                                "line_number": 172
+                                "line_number": 196
                               },
                               {
-                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 172",
+                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 196",
                                 "severity": "ERROR",
-                                "line_number": 172
+                                "line_number": 196
                               },
                               {
-                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 172",
+                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 196",
                                 "severity": "ERROR",
-                                "line_number": 172
+                                "line_number": 196
                               },
                               {
-                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 172",
+                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 196",
                                 "severity": "ERROR",
-                                "line_number": 172
+                                "line_number": 196
                               },
                               {
-                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 172",
+                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 196",
                                 "severity": "ERROR",
-                                "line_number": 172
+                                "line_number": 196
                               },
                               {
-                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 172",
+                                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_dict_value:Function] started at line 196",
                                 "severity": "ERROR",
-                                "line_number": 172
+                                "line_number": 196
                               }
                             ],
                             "score": 0.0
@@ -107920,29 +109257,29 @@
                         "valid": false,
                         "issues": [
                           {
-                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 147",
+                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 162",
                             "severity": "ERROR",
-                            "line_number": 147
+                            "line_number": 162
                           },
                           {
-                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 147",
+                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 162",
                             "severity": "ERROR",
-                            "line_number": 147
+                            "line_number": 162
                           },
                           {
-                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 147",
+                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 162",
                             "severity": "ERROR",
-                            "line_number": 147
+                            "line_number": 162
                           },
                           {
-                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 147",
+                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 162",
                             "severity": "ERROR",
-                            "line_number": 147
+                            "line_number": 162
                           },
                           {
-                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 147",
+                            "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key_single_filter:Function] started at line 162",
                             "severity": "ERROR",
-                            "line_number": 147
+                            "line_number": 162
                           }
                         ],
                         "score": 0.0
@@ -107953,24 +109290,24 @@
                     "valid": false,
                     "issues": [
                       {
-                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 116",
+                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 123",
                         "severity": "ERROR",
-                        "line_number": 116
+                        "line_number": 123
                       },
                       {
-                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 116",
+                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 123",
                         "severity": "ERROR",
-                        "line_number": 116
+                        "line_number": 123
                       },
                       {
-                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 116",
+                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 123",
                         "severity": "ERROR",
-                        "line_number": 116
+                        "line_number": 123
                       },
                       {
-                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 116",
+                        "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_key:Function] started at line 123",
                         "severity": "ERROR",
-                        "line_number": 116
+                        "line_number": 123
                       }
                     ],
                     "score": 0.0
@@ -107981,19 +109318,19 @@
                 "valid": false,
                 "issues": [
                   {
-                    "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink_direct_response:Function] started at line 90",
+                    "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink_direct_response:Function] started at line 95",
                     "severity": "ERROR",
-                    "line_number": 90
+                    "line_number": 95
                   },
                   {
-                    "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink_direct_response:Function] started at line 90",
+                    "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink_direct_response:Function] started at line 95",
                     "severity": "ERROR",
-                    "line_number": 90
+                    "line_number": 95
                   },
                   {
-                    "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink_direct_response:Function] started at line 90",
+                    "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink_direct_response:Function] started at line 95",
                     "severity": "ERROR",
-                    "line_number": 90
+                    "line_number": 95
                   }
                 ],
                 "score": 0.0
@@ -108004,14 +109341,14 @@
             "valid": false,
             "issues": [
               {
-                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink:Function] started at line 43",
+                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink:Function] started at line 46",
                 "severity": "ERROR",
-                "line_number": 43
+                "line_number": 46
               },
               {
-                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink:Function] started at line 43",
+                "message": "Unclosed Anchor: [DEF:test_extract_native_filters_from_permalink:Function] started at line 46",
                 "severity": "ERROR",
-                "line_number": 43
+                "line_number": 46
               }
             ],
             "score": 0.0
@@ -110214,8 +111551,8 @@
           "target": "TaskManager"
         },
         {
-          "type": "CALLS",
-          "target": "_add_log"
+          "type": "DEPENDS_ON",
+          "target": "EventBus"
         }
       ],
       "children": [
@@ -110232,7 +111569,7 @@
             "COMPLEXITY": "2",
             "INVARIANT": "All log calls include the task_id and source.",
             "UX_STATE": "Idle -> Logging -> (system records log)",
-            "TEST_CONTRACT": "TaskLoggerModel ->",
+            "TEST_CONTRACT": "TaskLoggerContract ->",
             "TEST_FIXTURE": "valid_task_logger -> {\"task_id\": \"test_123\", \"add_log_fn\": lambda *args: None, \"source\": \"test_plugin\"}",
             "TEST_EDGE": "invalid_add_log_fn -> raises TypeError",
             "TEST_INVARIANT": "consistent_delegation -> verifies: [valid_task_logger]"
@@ -110243,12 +111580,12 @@
               "target": "TaskManager"
             },
             {
-              "type": "CALLS",
-              "target": "_add_log"
+              "type": "DEPENDS_ON",
+              "target": "EventBus"
             },
             {
               "type": "USED_BY",
-              "target": "TaskManager"
+              "target": "TaskContext"
             }
           ],
           "children": [
@@ -110453,7 +111790,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 558,
+      "end_line": 624,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "persistence, sqlite, sqlalchemy, task, storage",
@@ -110467,9 +111804,13 @@
       },
       "relations": [
         {
-          "type": "USED_BY",
+          "type": "DEPENDS_ON",
           "target": "TaskManager"
         },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskGraph"
+        },
         {
           "type": "DEPENDS_ON",
           "target": "TasksSessionLocal"
@@ -110481,8 +111822,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 28,
-          "end_line": 306,
+          "start_line": 30,
+          "end_line": 343,
           "tags": {
             "COMPLEXITY": "5",
             "SEMANTICS": "persistence, service, database, sqlalchemy",
@@ -110492,7 +111833,7 @@
             "SIDE_EFFECT": "Opens SQLAlchemy sessions, reads and writes task_records rows, resolves environment foreign keys against environments, commits or rolls back transactions, and emits error logs on persistence failures.",
             "DATA_CONTRACT": "Input[Task | List[Task] | List[str] | Query(limit:int,status:Optional[TaskStatus])] -> Model[TaskRecord, Environment] -> Output[None | List[Task]]",
             "INVARIANT": "Persistence must handle potentially missing task fields natively.",
-            "TEST_CONTRACT": "TaskPersistenceService ->",
+            "TEST_CONTRACT": "TaskPersistenceContract ->",
             "TEST_FIXTURE": "valid_task_persistence -> {\"task_id\": \"123\", \"status\": \"PENDING\"}",
             "TEST_EDGE": "load_corrupt_json_params -> handled gracefully",
             "TEST_INVARIANT": "accurate_round_trip -> verifies: [valid_task_persistence, load_corrupt_json_params]"
@@ -110511,8 +111852,12 @@
               "target": "Environment"
             },
             {
-              "type": "USED_BY",
+              "type": "DEPENDS_ON",
               "target": "TaskManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "TaskGraph"
             }
           ],
           "children": [
@@ -110521,8 +111866,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 56,
-              "end_line": 77,
+              "start_line": 59,
+              "end_line": 81,
               "tags": {
                 "COMPLEXITY": "1",
                 "PURPOSE": "Safely load JSON strings from DB if necessary",
@@ -110542,8 +111887,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 79,
-              "end_line": 95,
+              "start_line": 83,
+              "end_line": 100,
               "tags": {
                 "COMPLEXITY": "1",
                 "PURPOSE": "Safely parse a datetime string from the database",
@@ -110563,8 +111908,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 97,
-              "end_line": 135,
+              "start_line": 102,
+              "end_line": 150,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Resolve environment id into existing environments.id value to satisfy FK constraints.",
@@ -110590,8 +111935,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 137,
-              "end_line": 146,
+              "start_line": 152,
+              "end_line": 162,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Initializes the persistence service.",
@@ -110606,17 +111951,17 @@
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                     "severity": "WARNING",
-                    "line_number": 137
+                    "line_number": 152
                   },
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                     "severity": "WARNING",
-                    "line_number": 137
+                    "line_number": 152
                   },
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                     "severity": "WARNING",
-                    "line_number": 137
+                    "line_number": 152
                   }
                 ],
                 "score": 0.4
@@ -110627,8 +111972,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 148,
-              "end_line": 211,
+              "start_line": 164,
+              "end_line": 234,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Persists or updates a single task in the database.",
@@ -110656,8 +112001,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 213,
-              "end_line": 224,
+              "start_line": 236,
+              "end_line": 248,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Persists multiple tasks.",
@@ -110683,8 +112028,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 226,
-              "end_line": 282,
+              "start_line": 250,
+              "end_line": 314,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Loads tasks from the database.",
@@ -110716,8 +112061,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 284,
-              "end_line": 305,
+              "start_line": 316,
+              "end_line": 340,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Deletes specific tasks from the database.",
@@ -110741,20 +112086,9 @@
             }
           ],
           "compliance": {
-            "valid": false,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "ERROR",
-                "line_number": 28
-              },
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "ERROR",
-                "line_number": 28
-              }
-            ],
-            "score": 0.0
+            "valid": true,
+            "issues": [],
+            "score": 0.9571428571428571
           }
         },
         {
@@ -110762,8 +112096,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 308,
-          "end_line": 557,
+          "start_line": 346,
+          "end_line": 623,
           "tags": {
             "COMPLEXITY": "5",
             "SEMANTICS": "persistence, service, database, log, sqlalchemy",
@@ -110773,7 +112107,7 @@
             "SIDE_EFFECT": "Opens SQLAlchemy sessions, inserts, reads, aggregates, and deletes task_logs rows, serializes log metadata to JSON, commits or rolls back transactions, and emits error logs on persistence failures.",
             "DATA_CONTRACT": "Input[task_id:str, logs:List[LogEntry], log_filter:LogFilter, task_ids:List[str]] -> Model[TaskLogRecord] -> Output[None | List[TaskLog] | LogStats | List[str]]",
             "INVARIANT": "Log entries are batch-inserted for performance.",
-            "TEST_CONTRACT": "TaskLogPersistenceService ->",
+            "TEST_CONTRACT": "TaskLogPersistenceContract ->",
             "TEST_FIXTURE": "valid_log_batch -> {\"task_id\": \"123\", \"logs\": [{\"level\": \"INFO\", \"message\": \"msg\"}]}",
             "TEST_EDGE": "add_logs_db_error -> rollback and log error",
             "TEST_INVARIANT": "accurate_log_aggregation -> verifies: [valid_log_batch]"
@@ -110788,8 +112122,12 @@
               "target": "TasksSessionLocal"
             },
             {
-              "type": "USED_BY",
+              "type": "DEPENDS_ON",
               "target": "TaskManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "EventBus"
             }
           ],
           "children": [
@@ -110798,8 +112136,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 339,
-              "end_line": 346,
+              "start_line": 378,
+              "end_line": 386,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Initializes the TaskLogPersistenceService",
@@ -110814,17 +112152,17 @@
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                     "severity": "WARNING",
-                    "line_number": 339
+                    "line_number": 378
                   },
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                     "severity": "WARNING",
-                    "line_number": 339
+                    "line_number": 378
                   },
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                     "severity": "WARNING",
-                    "line_number": 339
+                    "line_number": 378
                   }
                 ],
                 "score": 0.4
@@ -110835,8 +112173,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 348,
-              "end_line": 380,
+              "start_line": 388,
+              "end_line": 423,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Batch insert log entries for a task.",
@@ -110864,8 +112202,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 382,
-              "end_line": 437,
+              "start_line": 425,
+              "end_line": 487,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Query logs for a task with filtering and pagination.",
@@ -110901,8 +112239,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 439,
-              "end_line": 486,
+              "start_line": 489,
+              "end_line": 540,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Get statistics about logs for a task.",
@@ -110934,8 +112272,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 488,
-              "end_line": 508,
+              "start_line": 542,
+              "end_line": 568,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Get unique sources for a task's logs.",
@@ -110963,8 +112301,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 510,
-              "end_line": 531,
+              "start_line": 570,
+              "end_line": 594,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Delete all logs for a specific task.",
@@ -110991,8 +112329,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 533,
-              "end_line": 556,
+              "start_line": 596,
+              "end_line": 620,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Delete all logs for multiple tasks.",
@@ -111016,20 +112354,9 @@
             }
           ],
           "compliance": {
-            "valid": false,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "ERROR",
-                "line_number": 308
-              },
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "ERROR",
-                "line_number": 308
-              }
-            ],
-            "score": 0.0
+            "valid": true,
+            "issues": [],
+            "score": 0.9571428571428571
           }
         },
         {
@@ -111037,8 +112364,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 122,
-          "end_line": 122,
+          "start_line": 133,
+          "end_line": 133,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -111056,844 +112383,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 174,
-          "end_line": 174,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        }
-      ],
-      "compliance": {
-        "valid": false,
-        "issues": [
-          {
-            "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "ERROR",
-            "line_number": 1
-          },
-          {
-            "message": "Fractal limit warning: Module length is 558 lines (must be < 300)",
-            "severity": "WARNING",
-            "line_number": 1
-          }
-        ],
-        "score": 0.31666666666666665
-      }
-    },
-    {
-      "name": "TaskManager",
-      "type": "Module",
-      "complexity": 5,
-      "tier": "CRITICAL",
-      "start_line": 1,
-      "end_line": 744,
-      "tags": {
-        "TIER": "CRITICAL",
-        "COMPLEXITY": "5",
-        "SEMANTICS": "task, manager, lifecycle, execution, state",
-        "PURPOSE": "Manages the lifecycle of tasks, including their creation, execution, and state tracking. It uses a thread pool to run plugins asynchronously.",
-        "LAYER": "Core",
-        "PRE": "Plugin loader and database sessions are initialized.",
-        "POST": "Orchestrates task execution and persistence.",
-        "SIDE_EFFECT": "Spawns worker threads and flushes logs to DB.",
-        "DATA_CONTRACT": "Input[plugin_id, params] -> Model[Task, LogEntry]",
-        "INVARIANT": "Task IDs are unique.",
-        "CONSTRAINT": "Must use belief_scope for logging.",
-        "TEST_CONTRACT": "TaskManagerModule -> {",
-        "TEST_FIXTURE": "valid_module -> {\"manager_initialized\": true}",
-        "TEST_EDGE": "external_failure -> {\"db_unavailable\": true}",
-        "TEST_INVARIANT": "logger_compliance -> verifies: [valid_module]"
-      },
-      "relations": [
-        {
-          "type": "DEPENDS_ON",
-          "target": "PluginLoader"
-        },
-        {
-          "type": "DEPENDS_ON",
-          "target": "TaskPersistenceService"
-        },
-        {
-          "type": "DEPENDS_ON",
-          "target": "TaskLogPersistenceService"
-        }
-      ],
-      "children": [
-        {
-          "name": "TaskManager",
-          "type": "Class",
-          "complexity": 5,
-          "tier": "CRITICAL",
-          "start_line": 43,
-          "end_line": 743,
-          "tags": {
-            "TIER": "CRITICAL",
-            "COMPLEXITY": "5",
-            "SEMANTICS": "task, manager, lifecycle, execution, state",
-            "PURPOSE": "Manages the lifecycle of tasks, including their creation, execution, and state tracking.",
-            "LAYER": "Core",
-            "INVARIANT": "Log entries are never deleted after being added to a task.",
-            "SIDE_EFFECT": "Spawns worker threads, flushes logs to database, and mutates task states.",
-            "DATA_CONTRACT": "Input[plugin_id, params] -> Output[Task]"
-          },
-          "relations": [
-            {
-              "type": "DEPENDS_ON",
-              "target": "TaskPersistenceService"
-            },
-            {
-              "type": "DEPENDS_ON",
-              "target": "TaskLogPersistenceService"
-            },
-            {
-              "type": "DEPENDS_ON",
-              "target": "PluginLoader"
-            }
-          ],
-          "children": [
-            {
-              "name": "__init__",
-              "type": "Function",
-              "complexity": 5,
-              "tier": "CRITICAL",
-              "start_line": 65,
-              "end_line": 104,
-              "tags": {
-                "COMPLEXITY": "5",
-                "PURPOSE": "Initialize the TaskManager with dependencies.",
-                "PRE": "plugin_loader is initialized.",
-                "POST": "TaskManager is ready to accept tasks.",
-                "SIDE_EFFECT": "Starts background flusher thread and loads persisted task state into memory.",
-                "PARAM": "plugin_loader - The plugin loader instance."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.load_tasks"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": false,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 65
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 65
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 65
-                  }
-                ],
-                "score": 0.0
-              }
-            },
-            {
-              "name": "_flusher_loop",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 106,
-              "end_line": 118,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Background thread that periodically flushes log buffer to database.",
-                "PRE": "TaskManager is initialized.",
-                "POST": "Logs are batch-written to database every LOG_FLUSH_INTERVAL seconds."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskManager._flush_logs"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "_flush_logs",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 120,
-              "end_line": 147,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Flush all buffered logs to the database.",
-                "PRE": "None.",
-                "POST": "All buffered logs are written to task_logs table."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskLogPersistenceService.add_logs"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "_flush_task_logs",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 149,
-              "end_line": 168,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Flush logs for a specific task immediately.",
-                "PRE": "task_id exists.",
-                "POST": "Task's buffered logs are written to database.",
-                "PARAM": "task_id (str) - The task ID."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskLogPersistenceService.add_logs"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "create_task",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 170,
-              "end_line": 204,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Creates and queues a new task for execution.",
-                "PRE": "Plugin with plugin_id exists. Params are valid.",
-                "POST": "Task is created, added to registry, and scheduled for execution.",
-                "PARAM": "user_id (Optional[str]) - ID of the user requesting the task.",
-                "RETURN": "Task - The created task instance.",
-                "THROWS": "ValueError if plugin not found or params invalid."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.persist_task"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "_run_task",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 206,
-              "end_line": 292,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Internal method to execute a task with TaskContext support.",
-                "PRE": "Task exists in registry.",
-                "POST": "Task is executed, status updated to SUCCESS or FAILED.",
-                "PARAM": "task_id (str) - The ID of the task to run."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.persist_task"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "resolve_task",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 294,
-              "end_line": 319,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Resumes a task that is awaiting mapping.",
-                "PRE": "Task exists and is in AWAITING_MAPPING state.",
-                "POST": "Task status updated to RUNNING, params updated, execution resumed.",
-                "PARAM": "resolution_params (Dict[str, Any]) - Params to resolve the wait.",
-                "THROWS": "ValueError if task not found or not awaiting mapping."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.persist_task"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "wait_for_resolution",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 321,
-              "end_line": 344,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Pauses execution and waits for a resolution signal.",
-                "PRE": "Task exists.",
-                "POST": "Execution pauses until future is set.",
-                "PARAM": "task_id (str) - The ID of the task."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.persist_task"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "wait_for_input",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 346,
-              "end_line": 368,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Pauses execution and waits for user input.",
-                "PRE": "Task exists.",
-                "POST": "Execution pauses until future is set via resume_task_with_password.",
-                "PARAM": "task_id (str) - The ID of the task."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "asyncio.AbstractEventLoop.create_future"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "get_task",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 370,
-              "end_line": 382,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Retrieves a task by its ID.",
-                "PRE": "task_id is a string.",
-                "POST": "Returns Task object or None.",
-                "PARAM": "task_id (str) - ID of the task.",
-                "RETURN": "Optional[Task] - The task or None."
-              },
-              "relations": [
-                {
-                  "type": "READS",
-                  "target": "TaskManager.tasks"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 370
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 370
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 370
-                  }
-                ],
-                "score": 0.4
-              }
-            },
-            {
-              "name": "get_all_tasks",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 384,
-              "end_line": 395,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Retrieves all registered tasks.",
-                "PRE": "None.",
-                "POST": "Returns list of all Task objects.",
-                "RETURN": "List[Task] - All tasks."
-              },
-              "relations": [
-                {
-                  "type": "READS",
-                  "target": "TaskManager.tasks"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 384
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 384
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 384
-                  }
-                ],
-                "score": 0.4
-              }
-            },
-            {
-              "name": "get_tasks",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 397,
-              "end_line": 441,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Retrieves tasks with pagination and optional status filter.",
-                "PRE": "limit and offset are non-negative integers.",
-                "POST": "Returns a list of tasks sorted by start_time descending.",
-                "PARAM": "status (Optional[TaskStatus]) - Filter by task status.",
-                "RETURN": "List[Task] - List of tasks matching criteria."
-              },
-              "relations": [
-                {
-                  "type": "READS",
-                  "target": "TaskManager.tasks"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 397
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 397
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: READS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 397
-                  }
-                ],
-                "score": 0.4
-              }
-            },
-            {
-              "name": "get_task_logs",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 443,
-              "end_line": 478,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Retrieves logs for a specific task (from memory for running, persistence for completed).",
-                "PRE": "task_id is a string.",
-                "POST": "Returns list of LogEntry or TaskLog objects.",
-                "PARAM": "log_filter (Optional[LogFilter]) - Filter parameters.",
-                "RETURN": "List[LogEntry] - List of log entries."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskLogPersistenceService.get_logs"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "get_task_log_stats",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 480,
-              "end_line": 492,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Get statistics about logs for a task.",
-                "PRE": "task_id is a valid task ID.",
-                "POST": "Returns LogStats with counts by level and source.",
-                "PARAM": "task_id (str) - The task ID.",
-                "RETURN": "LogStats - Statistics about task logs."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskLogPersistenceService.get_log_stats"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "get_task_log_sources",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 494,
-              "end_line": 506,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Get unique sources for a task's logs.",
-                "PRE": "task_id is a valid task ID.",
-                "POST": "Returns list of unique source strings.",
-                "PARAM": "task_id (str) - The task ID.",
-                "RETURN": "List[str] - Unique source names."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskLogPersistenceService.get_sources"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "_add_log",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 508,
-              "end_line": 561,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Adds a log entry to a task buffer and notifies subscribers.",
-                "PRE": "Task exists.",
-                "POST": "Log added to buffer and pushed to queues (if level meets task_log_level filter).",
-                "PARAM": "context (Optional[Dict]) - Legacy context (for backward compatibility)."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "should_log_task_level"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "subscribe_logs",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 563,
-              "end_line": 579,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Subscribes to real-time logs for a task.",
-                "PRE": "task_id is a string.",
-                "POST": "Returns an asyncio.Queue for log entries.",
-                "PARAM": "task_id (str) - ID of the task.",
-                "RETURN": "asyncio.Queue - Queue for log entries."
-              },
-              "relations": [
-                {
-                  "type": "MUTATES",
-                  "target": "TaskManager.subscribers"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [
-                  {
-                    "message": "Invalid @RELATION predicate: MUTATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 563
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: MUTATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 563
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: MUTATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 563
-                  }
-                ],
-                "score": 0.4
-              }
-            },
-            {
-              "name": "unsubscribe_logs",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 581,
-              "end_line": 597,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Unsubscribes from real-time logs for a task.",
-                "PRE": "task_id is a string, queue is asyncio.Queue.",
-                "POST": "Queue removed from subscribers.",
-                "PARAM": "queue (asyncio.Queue) - Queue to remove."
-              },
-              "relations": [
-                {
-                  "type": "MUTATES",
-                  "target": "TaskManager.subscribers"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [
-                  {
-                    "message": "Invalid @RELATION predicate: MUTATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 581
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: MUTATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 581
-                  },
-                  {
-                    "message": "Invalid @RELATION predicate: MUTATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                    "severity": "WARNING",
-                    "line_number": 581
-                  }
-                ],
-                "score": 0.4
-              }
-            },
-            {
-              "name": "load_persisted_tasks",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 599,
-              "end_line": 612,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Load persisted tasks using persistence service.",
-                "PRE": "None.",
-                "POST": "Persisted tasks loaded into self.tasks."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.load_tasks"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "await_input",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 614,
-              "end_line": 644,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Transition a task to AWAITING_INPUT state with input request.",
-                "PRE": "Task exists and is in RUNNING state.",
-                "POST": "Task status changed to AWAITING_INPUT, input_request set, persisted.",
-                "PARAM": "input_request (Dict) - Details about required input.",
-                "THROWS": "ValueError if task not found or not RUNNING."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.persist_task"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "resume_task_with_password",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 646,
-              "end_line": 687,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Resume a task that is awaiting input with provided passwords.",
-                "PRE": "Task exists and is in AWAITING_INPUT state.",
-                "POST": "Task status changed to RUNNING, passwords injected, task resumed.",
-                "PARAM": "passwords (Dict[str, str]) - Mapping of database name to password.",
-                "THROWS": "ValueError if task not found, not awaiting input, or passwords invalid."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.persist_task"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            },
-            {
-              "name": "clear_tasks",
-              "type": "Function",
-              "complexity": 3,
-              "tier": "STANDARD",
-              "start_line": 689,
-              "end_line": 740,
-              "tags": {
-                "COMPLEXITY": "3",
-                "PURPOSE": "Clears tasks based on status filter (also deletes associated logs).",
-                "PRE": "status is Optional[TaskStatus].",
-                "POST": "Tasks matching filter (or all non-active) cleared from registry and database.",
-                "PARAM": "status (Optional[TaskStatus]) - Filter by task status.",
-                "RETURN": "int - Number of tasks cleared."
-              },
-              "relations": [
-                {
-                  "type": "CALLS",
-                  "target": "TaskPersistenceService.delete_tasks"
-                }
-              ],
-              "children": [],
-              "compliance": {
-                "valid": true,
-                "issues": [],
-                "score": 0.85
-              }
-            }
-          ],
-          "compliance": {
-            "valid": false,
-            "issues": [
-              {
-                "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 43
-              },
-              {
-                "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 43
-              },
-              {
-                "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 43
-              },
-              {
-                "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 43
-              }
-            ],
-            "score": 0.0
-          }
-        },
-        {
-          "name": "sort_key",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 428,
-          "end_line": 428,
+          "start_line": 196,
+          "end_line": 196,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -111911,7 +112402,960 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 744 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 624 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 1
+          }
+        ],
+        "score": 0.8166666666666667
+      }
+    },
+    {
+      "name": "TaskManagerModule",
+      "type": "Module",
+      "complexity": 5,
+      "tier": "CRITICAL",
+      "start_line": 1,
+      "end_line": 829,
+      "tags": {
+        "COMPLEXITY": "5",
+        "SEMANTICS": "task, manager, lifecycle, execution, state",
+        "PURPOSE": "Manages the lifecycle of tasks, including their creation, execution, and state tracking. It uses a thread pool to run plugins asynchronously.",
+        "LAYER": "Core",
+        "PRE": "Plugin loader and database sessions are initialized.",
+        "POST": "Orchestrates task execution and persistence.",
+        "SIDE_EFFECT": "Spawns worker threads and flushes logs to DB.",
+        "DATA_CONTRACT": "Input[plugin_id, params] -> Model[Task, LogEntry]",
+        "INVARIANT": "Task IDs are unique.",
+        "CONSTRAINT": "Must use belief_scope for logging.",
+        "TEST_CONTRACT": "TaskManagerRuntime -> {",
+        "TEST_FIXTURE": "valid_module -> {\"manager_initialized\": true}",
+        "TEST_EDGE": "external_failure -> {\"db_unavailable\": true}",
+        "TEST_INVARIANT": "logger_compliance -> verifies: [valid_module]"
+      },
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "PluginLoader"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskPersistenceService"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskLogPersistenceService"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskContext"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskGraph"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "JobLifecycle"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "EventBus"
+        }
+      ],
+      "children": [
+        {
+          "name": "TaskManager",
+          "type": "Class",
+          "complexity": 5,
+          "tier": "CRITICAL",
+          "start_line": 46,
+          "end_line": 828,
+          "tags": {
+            "COMPLEXITY": "5",
+            "SEMANTICS": "task, manager, lifecycle, execution, state",
+            "PURPOSE": "Manages the lifecycle of tasks, including their creation, execution, and state tracking.",
+            "LAYER": "Core",
+            "PRE": "Plugin loader resolves plugin ids and persistence services are available for task state hydration.",
+            "POST": "In-memory task graph, lifecycle scheduler, and log event bus stay consistent with persisted task state.",
+            "INVARIANT": "Log entries are never deleted after being added to a task.",
+            "SIDE_EFFECT": "Spawns worker threads, flushes logs to database, and mutates task states.",
+            "DATA_CONTRACT": "Input[plugin_id, params] -> Output[Task]"
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "TaskPersistenceService"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "TaskLogPersistenceService"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "PluginLoader"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "TaskContext"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "TaskGraph"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "JobLifecycle"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "EventBus"
+            }
+          ],
+          "children": [
+            {
+              "name": "TaskGraph",
+              "type": "Block",
+              "complexity": 5,
+              "tier": "CRITICAL",
+              "start_line": 73,
+              "end_line": 83,
+              "tags": {
+                "COMPLEXITY": "5",
+                "PURPOSE": "Represents the in-memory task dependency graph spanning task registry nodes, paused futures, and persistence-backed hydration.",
+                "PRE": "Task ids are generated before insertion and persisted tasks can be reconstructed into Task models.",
+                "POST": "Each live task id resolves to at most one active Task node and optional pause future.",
+                "SIDE_EFFECT": "Mutates the in-memory task registry and loads persisted state during manager startup.",
+                "DATA_CONTRACT": "Input[Task lifecycle events] -> Output[tasks:Dict[str, Task], task_futures:Dict[str, asyncio.Future]]",
+                "INVARIANT": "Registry membership is keyed by unique task id and survives log streaming side channels."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "Task"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskPersistenceService"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 1.0
+              }
+            },
+            {
+              "name": "EventBus",
+              "type": "Block",
+              "complexity": 5,
+              "tier": "CRITICAL",
+              "start_line": 85,
+              "end_line": 95,
+              "tags": {
+                "COMPLEXITY": "5",
+                "PURPOSE": "Coordinates task-scoped log buffering, persistence flushes, and subscriber fan-out for real-time observers.",
+                "PRE": "Task log records accept structured LogEntry payloads and subscribers consume asyncio queues.",
+                "POST": "Accepted task logs are buffered, optionally persisted, and dispatched to active subscribers in emission order.",
+                "SIDE_EFFECT": "Writes task logs to persistence, mutates in-memory buffers, and pushes log entries into subscriber queues.",
+                "DATA_CONTRACT": "Input[task_id, LogEntry, Queue subscribers] -> Output[persisted log rows, streamed log events]",
+                "INVARIANT": "Buffered logs are retried on persistence failure and every subscriber receives only task-scoped events."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LogEntry"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskLogPersistenceService"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 1.0
+              }
+            },
+            {
+              "name": "JobLifecycle",
+              "type": "Block",
+              "complexity": 5,
+              "tier": "CRITICAL",
+              "start_line": 97,
+              "end_line": 109,
+              "tags": {
+                "COMPLEXITY": "5",
+                "PURPOSE": "Encodes task creation, execution, pause/resume, and completion transitions for plugin-backed jobs.",
+                "PRE": "Requested plugin ids resolve to executable plugins and task state transitions target known TaskStatus values.",
+                "POST": "Every scheduled task transitions through a valid lifecycle path ending in persisted terminal or waiting state.",
+                "SIDE_EFFECT": "Schedules async execution, pauses on input/mapping requests, and mutates persisted task lifecycle markers.",
+                "DATA_CONTRACT": "Input[plugin_id, params, task_id, resolution payloads] -> Output[Task status transitions, task result]",
+                "INVARIANT": "A task cannot be resumed from a waiting state unless a matching future exists or a new wait future is created."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskContext"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "PluginLoader"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 1.0
+              }
+            },
+            {
+              "name": "__init__",
+              "type": "Function",
+              "complexity": 5,
+              "tier": "CRITICAL",
+              "start_line": 111,
+              "end_line": 157,
+              "tags": {
+                "COMPLEXITY": "5",
+                "PURPOSE": "Initialize the TaskManager with dependencies.",
+                "PRE": "plugin_loader is initialized.",
+                "POST": "TaskManager is ready to accept tasks.",
+                "SIDE_EFFECT": "Starts background flusher thread and loads persisted task state into memory.",
+                "PARAM": "plugin_loader - The plugin loader instance."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.load_tasks"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": false,
+                "issues": [
+                  {
+                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
+                    "severity": "ERROR",
+                    "line_number": 111
+                  },
+                  {
+                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
+                    "severity": "ERROR",
+                    "line_number": 111
+                  },
+                  {
+                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
+                    "severity": "ERROR",
+                    "line_number": 111
+                  }
+                ],
+                "score": 0.0
+              }
+            },
+            {
+              "name": "_flusher_loop",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 159,
+              "end_line": 172,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Background thread that periodically flushes log buffer to database.",
+                "PRE": "TaskManager is initialized.",
+                "POST": "Logs are batch-written to database every LOG_FLUSH_INTERVAL seconds."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskManager._flush_logs"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_flush_logs",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 174,
+              "end_line": 202,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Flush all buffered logs to the database.",
+                "PRE": "None.",
+                "POST": "All buffered logs are written to task_logs table."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskLogPersistenceService.add_logs"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_flush_task_logs",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 204,
+              "end_line": 224,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Flush logs for a specific task immediately.",
+                "PRE": "task_id exists.",
+                "POST": "Task's buffered logs are written to database.",
+                "PARAM": "task_id (str) - The task ID."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskLogPersistenceService.add_logs"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "create_task",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 226,
+              "end_line": 267,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Creates and queues a new task for execution.",
+                "PRE": "Plugin with plugin_id exists. Params are valid.",
+                "POST": "Task is created, added to registry, and scheduled for execution.",
+                "PARAM": "user_id (Optional[str]) - ID of the user requesting the task.",
+                "RETURN": "Task - The created task instance.",
+                "THROWS": "ValueError if plugin not found or params invalid."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.persist_task"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "JobLifecycle"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_run_task",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 269,
+              "end_line": 366,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Internal method to execute a task with TaskContext support.",
+                "PRE": "Task exists in registry.",
+                "POST": "Task is executed, status updated to SUCCESS or FAILED.",
+                "PARAM": "task_id (str) - The ID of the task to run."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.persist_task"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "JobLifecycle"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskContext"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "resolve_task",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 368,
+              "end_line": 394,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Resumes a task that is awaiting mapping.",
+                "PRE": "Task exists and is in AWAITING_MAPPING state.",
+                "POST": "Task status updated to RUNNING, params updated, execution resumed.",
+                "PARAM": "resolution_params (Dict[str, Any]) - Params to resolve the wait.",
+                "THROWS": "ValueError if task not found or not awaiting mapping."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.persist_task"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "JobLifecycle"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "wait_for_resolution",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 396,
+              "end_line": 420,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Pauses execution and waits for a resolution signal.",
+                "PRE": "Task exists.",
+                "POST": "Execution pauses until future is set.",
+                "PARAM": "task_id (str) - The ID of the task."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.persist_task"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "JobLifecycle"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "wait_for_input",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 422,
+              "end_line": 444,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Pauses execution and waits for user input.",
+                "PRE": "Task exists.",
+                "POST": "Execution pauses until future is set via resume_task_with_password.",
+                "PARAM": "task_id (str) - The ID of the task."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "JobLifecycle"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "get_task",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 446,
+              "end_line": 458,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Retrieves a task by its ID.",
+                "PRE": "task_id is a string.",
+                "POST": "Returns Task object or None.",
+                "PARAM": "task_id (str) - ID of the task.",
+                "RETURN": "Optional[Task] - The task or None."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "get_all_tasks",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 460,
+              "end_line": 471,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Retrieves all registered tasks.",
+                "PRE": "None.",
+                "POST": "Returns list of all Task objects.",
+                "RETURN": "List[Task] - All tasks."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "get_tasks",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 473,
+              "end_line": 517,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Retrieves tasks with pagination and optional status filter.",
+                "PRE": "limit and offset are non-negative integers.",
+                "POST": "Returns a list of tasks sorted by start_time descending.",
+                "PARAM": "status (Optional[TaskStatus]) - Filter by task status.",
+                "RETURN": "List[Task] - List of tasks matching criteria."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "get_task_logs",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 519,
+              "end_line": 555,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Retrieves logs for a specific task (from memory for running, persistence for completed).",
+                "PRE": "task_id is a string.",
+                "POST": "Returns list of LogEntry or TaskLog objects.",
+                "PARAM": "log_filter (Optional[LogFilter]) - Filter parameters.",
+                "RETURN": "List[LogEntry] - List of log entries."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskLogPersistenceService.get_logs"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "get_task_log_stats",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 557,
+              "end_line": 570,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Get statistics about logs for a task.",
+                "PRE": "task_id is a valid task ID.",
+                "POST": "Returns LogStats with counts by level and source.",
+                "PARAM": "task_id (str) - The task ID.",
+                "RETURN": "LogStats - Statistics about task logs."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskLogPersistenceService.get_log_stats"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "get_task_log_sources",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 572,
+              "end_line": 585,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Get unique sources for a task's logs.",
+                "PRE": "task_id is a valid task ID.",
+                "POST": "Returns list of unique source strings.",
+                "PARAM": "task_id (str) - The task ID.",
+                "RETURN": "List[str] - Unique source names."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskLogPersistenceService.get_sources"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_add_log",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 587,
+              "end_line": 641,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Adds a log entry to a task buffer and notifies subscribers.",
+                "PRE": "Task exists.",
+                "POST": "Log added to buffer and pushed to queues (if level meets task_log_level filter).",
+                "PARAM": "context (Optional[Dict]) - Legacy context (for backward compatibility)."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "should_log_task_level"
+                },
+                {
+                  "type": "DISPATCHES",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "subscribe_logs",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 643,
+              "end_line": 659,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Subscribes to real-time logs for a task.",
+                "PRE": "task_id is a string.",
+                "POST": "Returns an asyncio.Queue for log entries.",
+                "PARAM": "task_id (str) - ID of the task.",
+                "RETURN": "asyncio.Queue - Queue for log entries."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "unsubscribe_logs",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 661,
+              "end_line": 677,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Unsubscribes from real-time logs for a task.",
+                "PRE": "task_id is a string, queue is asyncio.Queue.",
+                "POST": "Queue removed from subscribers.",
+                "PARAM": "queue (asyncio.Queue) - Queue to remove."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "load_persisted_tasks",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 679,
+              "end_line": 693,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Load persisted tasks using persistence service.",
+                "PRE": "None.",
+                "POST": "Persisted tasks loaded into self.tasks."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.load_tasks"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "await_input",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 695,
+              "end_line": 726,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Transition a task to AWAITING_INPUT state with input request.",
+                "PRE": "Task exists and is in RUNNING state.",
+                "POST": "Task status changed to AWAITING_INPUT, input_request set, persisted.",
+                "PARAM": "input_request (Dict) - Details about required input.",
+                "THROWS": "ValueError if task not found or not RUNNING."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.persist_task"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "JobLifecycle"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "resume_task_with_password",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 728,
+              "end_line": 770,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Resume a task that is awaiting input with provided passwords.",
+                "PRE": "Task exists and is in AWAITING_INPUT state.",
+                "POST": "Task status changed to RUNNING, passwords injected, task resumed.",
+                "PARAM": "passwords (Dict[str, str]) - Mapping of database name to password.",
+                "THROWS": "ValueError if task not found, not awaiting input, or passwords invalid."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.persist_task"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "JobLifecycle"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "clear_tasks",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 772,
+              "end_line": 825,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Clears tasks based on status filter (also deletes associated logs).",
+                "PRE": "status is Optional[TaskStatus].",
+                "POST": "Tasks matching filter (or all non-active) cleared from registry and database.",
+                "PARAM": "status (Optional[TaskStatus]) - Filter by task status.",
+                "RETURN": "int - Number of tasks cleared."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "TaskPersistenceService.delete_tasks"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskGraph"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EventBus"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            }
+          ],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 0.9571428571428571
+          }
+        },
+        {
+          "name": "sort_key",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 504,
+          "end_line": 504,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        }
+      ],
+      "compliance": {
+        "valid": true,
+        "issues": [
+          {
+            "message": "Fractal limit warning: Module length is 829 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -111941,7 +113385,7 @@
         },
         {
           "type": "USED_BY",
-          "target": "ApiRoutes"
+          "target": "TaskManagerPackage"
         }
       ],
       "children": [
@@ -111979,7 +113423,7 @@
           },
           "relations": [
             {
-              "type": "USED_BY",
+              "type": "DEPENDS_ON",
               "target": "LogEntry"
             },
             {
@@ -111991,16 +113435,6 @@
           "compliance": {
             "valid": true,
             "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 37
-              },
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 37
-              },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
@@ -112012,7 +113446,7 @@
                 "line_number": 37
               }
             ],
-            "score": 0.4
+            "score": 0.7
           }
         },
         {
@@ -112037,26 +113471,15 @@
               "target": "LogLevel"
             },
             {
-              "type": "PART_OF",
+              "type": "DEPENDS_ON",
               "target": "Task"
             }
           ],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: PART_OF. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 53
-              },
-              {
-                "message": "Invalid @RELATION predicate: PART_OF. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 53
-              }
-            ],
-            "score": 0.7
+            "issues": [],
+            "score": 1.0
           }
         },
         {
@@ -112073,26 +113496,15 @@
           },
           "relations": [
             {
-              "type": "MAPS_TO",
+              "type": "DEPENDS_ON",
               "target": "TaskLogRecord"
             }
           ],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: MAPS_TO. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 86
-              },
-              {
-                "message": "Invalid @RELATION predicate: MAPS_TO. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 86
-              }
-            ],
-            "score": 0.5499999999999999
+            "issues": [],
+            "score": 0.85
           }
         },
         {
@@ -112109,26 +113521,15 @@
           },
           "relations": [
             {
-              "type": "USED_BY",
+              "type": "DEPENDS_ON",
               "target": "TaskManager"
             }
           ],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 107
-              },
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 107
-              }
-            ],
-            "score": 0.7
+            "issues": [],
+            "score": 1.0
           }
         },
         {
@@ -112145,26 +113546,15 @@
           },
           "relations": [
             {
-              "type": "COMPUTED_FROM",
+              "type": "DEPENDS_ON",
               "target": "TaskLog"
             }
           ],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: COMPUTED_FROM. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 123
-              },
-              {
-                "message": "Invalid @RELATION predicate: COMPUTED_FROM. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 123
-              }
-            ],
-            "score": 0.7
+            "issues": [],
+            "score": 1.0
           }
         },
         {
@@ -112185,11 +113575,11 @@
               "target": "TaskStatus"
             },
             {
-              "type": "CONTAINS",
+              "type": "DEPENDS_ON",
               "target": "LogEntry"
             },
             {
-              "type": "USED_BY",
+              "type": "DEPENDS_ON",
               "target": "TaskManager"
             }
           ],
@@ -112218,29 +113608,8 @@
           ],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: CONTAINS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 137
-              },
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 137
-              },
-              {
-                "message": "Invalid @RELATION predicate: CONTAINS. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 137
-              },
-              {
-                "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 137
-              }
-            ],
-            "score": 0.25
+            "issues": [],
+            "score": 0.85
           }
         }
       ],
@@ -112401,7 +113770,7 @@
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.core.task_manager.manager.TaskManager"
+          "target": "TaskManager"
         }
       ],
       "children": [],
@@ -112435,7 +113804,7 @@
           "target": "TaskLoggerModule"
         },
         {
-          "type": "USED_BY",
+          "type": "DEPENDS_ON",
           "target": "TaskManager"
         }
       ],
@@ -112457,7 +113826,7 @@
             "SIDE_EFFECT": "Emits structured task logs through TaskLogger on plugin interactions.",
             "DATA_CONTRACT": "Input[task_id, add_log_fn, params, default_source, background_tasks] -> Output[TaskContext]",
             "UX_STATE": "Idle -> Active -> Complete",
-            "TEST_CONTRACT": "TaskContextInit ->",
+            "TEST_CONTRACT": "TaskContextContract ->",
             "TEST_FIXTURE": "valid_context -> {\"task_id\": \"123\", \"add_log_fn\": lambda *args: None, \"params\": {\"k\": \"v\"}, \"default_source\": \"plugin\"}",
             "TEST_EDGE": "missing_add_log_fn -> raises TypeError",
             "TEST_INVARIANT": "logger_initialized -> verifies: [valid_context]"
@@ -112645,15 +114014,9 @@
         }
       ],
       "compliance": {
-        "valid": false,
-        "issues": [
-          {
-            "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "ERROR",
-            "line_number": 1
-          }
-        ],
-        "score": 0.4666666666666667
+        "valid": true,
+        "issues": [],
+        "score": 0.9666666666666667
       }
     },
     {
@@ -113153,181 +114516,290 @@
       }
     },
     {
-      "name": "router",
-      "type": "Global",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 17,
-      "end_line": 20,
+      "name": "LlmRoutes",
+      "type": "Module",
+      "complexity": 3,
+      "tier": "STANDARD",
+      "start_line": 1,
+      "end_line": 336,
       "tags": {
-        "PURPOSE": "APIRouter instance for LLM routes."
+        "COMPLEXITY": "3",
+        "SEMANTICS": "api, routes, llm",
+        "PURPOSE": "API routes for LLM provider configuration and management.",
+        "LAYER": "UI (API)"
       },
-      "relations": [],
-      "children": [],
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "LLMProviderService"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "LLMProviderConfig"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "get_current_user"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "get_db"
+        }
+      ],
+      "children": [
+        {
+          "name": "router",
+          "type": "Global",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 21,
+          "end_line": 24,
+          "tags": {
+            "PURPOSE": "APIRouter instance for LLM routes."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_is_valid_runtime_api_key",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 27,
+          "end_line": 41,
+          "tags": {
+            "PURPOSE": "Validate decrypted runtime API key presence/shape.",
+            "PRE": "value can be None.",
+            "POST": "Returns True only for non-placeholder key."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "LlmRoutes"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "get_providers",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 44,
+          "end_line": 76,
+          "tags": {
+            "PURPOSE": "Retrieve all LLM provider configurations.",
+            "PRE": "User is authenticated.",
+            "POST": "Returns list of LLMProviderConfig."
+          },
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "LLMProviderService"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMProviderConfig"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "get_llm_status",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 79,
+          "end_line": 147,
+          "tags": {
+            "PURPOSE": "Returns whether LLM runtime is configured for dashboard validation.",
+            "PRE": "User is authenticated.",
+            "POST": "configured=true only when an active provider with valid decrypted key exists."
+          },
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "LLMProviderService"
+            },
+            {
+              "type": "CALLS",
+              "target": "_is_valid_runtime_api_key"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "create_provider",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 150,
+          "end_line": 180,
+          "tags": {
+            "PURPOSE": "Create a new LLM provider configuration.",
+            "PRE": "User is authenticated and has admin permissions.",
+            "POST": "Returns the created LLMProviderConfig."
+          },
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "LLMProviderService"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMProviderConfig"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "update_provider",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 183,
+          "end_line": 215,
+          "tags": {
+            "PURPOSE": "Update an existing LLM provider configuration.",
+            "PRE": "User is authenticated and has admin permissions.",
+            "POST": "Returns the updated LLMProviderConfig."
+          },
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "LLMProviderService"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMProviderConfig"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "delete_provider",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 218,
+          "end_line": 238,
+          "tags": {
+            "PURPOSE": "Delete an LLM provider configuration.",
+            "PRE": "User is authenticated and has admin permissions.",
+            "POST": "Returns success status."
+          },
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "LLMProviderService"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "test_connection",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 241,
+          "end_line": 292,
+          "tags": {
+            "PURPOSE": "Test connection to an LLM provider.",
+            "PRE": "User is authenticated.",
+            "POST": "Returns success status and message."
+          },
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "LLMProviderService"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMClient"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "test_provider_config",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 295,
+          "end_line": 334,
+          "tags": {
+            "PURPOSE": "Test connection with a provided configuration (not yet saved).",
+            "PRE": "User is authenticated.",
+            "POST": "Returns success status and message."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMClient"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMProviderConfig"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        }
+      ],
       "compliance": {
         "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "_is_valid_runtime_api_key",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 23,
-      "end_line": 36,
-      "tags": {
-        "PURPOSE": "Validate decrypted runtime API key presence/shape.",
-        "PRE": "value can be None.",
-        "POST": "Returns True only for non-placeholder key."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "get_providers",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 39,
-      "end_line": 69,
-      "tags": {
-        "PURPOSE": "Retrieve all LLM provider configurations.",
-        "PRE": "User is authenticated.",
-        "POST": "Returns list of LLMProviderConfig."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "get_llm_status",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 72,
-      "end_line": 101,
-      "tags": {
-        "PURPOSE": "Returns whether LLM runtime is configured for dashboard validation.",
-        "PRE": "User is authenticated.",
-        "POST": "configured=true only when an active provider with valid decrypted key exists."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "create_provider",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 104,
-      "end_line": 132,
-      "tags": {
-        "PURPOSE": "Create a new LLM provider configuration.",
-        "PRE": "User is authenticated and has admin permissions.",
-        "POST": "Returns the created LLMProviderConfig."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "update_provider",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 135,
-      "end_line": 165,
-      "tags": {
-        "PURPOSE": "Update an existing LLM provider configuration.",
-        "PRE": "User is authenticated and has admin permissions.",
-        "POST": "Returns the updated LLMProviderConfig."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "delete_provider",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 168,
-      "end_line": 187,
-      "tags": {
-        "PURPOSE": "Delete an LLM provider configuration.",
-        "PRE": "User is authenticated and has admin permissions.",
-        "POST": "Returns success status."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_connection",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 190,
-      "end_line": 239,
-      "tags": {
-        "PURPOSE": "Test connection to an LLM provider.",
-        "PRE": "User is authenticated.",
-        "POST": "Returns success status and message."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_provider_config",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 242,
-      "end_line": 279,
-      "tags": {
-        "PURPOSE": "Test connection with a provided configuration (not yet saved).",
-        "PRE": "User is authenticated.",
-        "POST": "Returns success status and message."
-      },
-      "relations": [],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
+        "issues": [
+          {
+            "message": "Fractal limit warning: Module length is 336 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 1
+          }
+        ],
+        "score": 0.775
       }
     },
     {
@@ -115268,7 +116740,7 @@
       "complexity": 4,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 2021,
+      "end_line": 2231,
       "tags": {
         "COMPLEXITY": "4",
         "SEMANTICS": "dataset_review, api, session_lifecycle, exports, rbac, feature_flags",
@@ -115301,7 +116773,7 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 17,
-          "end_line": 80,
+          "end_line": 81,
           "tags": {},
           "relations": [],
           "children": [],
@@ -115316,8 +116788,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 85,
-          "end_line": 94,
+          "start_line": 86,
+          "end_line": 95,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for starting one dataset review session from a Superset link or dataset selection."
@@ -115335,8 +116807,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 97,
-          "end_line": 105,
+          "start_line": 98,
+          "end_line": 106,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for lifecycle state updates on an existing session."
@@ -115354,8 +116826,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 108,
-          "end_line": 119,
+          "start_line": 109,
+          "end_line": 120,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Paginated ownership-scoped dataset review session collection response."
@@ -115373,8 +116845,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 122,
-          "end_line": 136,
+          "start_line": 123,
+          "end_line": 137,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Inline export response for documentation or validation outputs without introducing unrelated persistence changes."
@@ -115392,8 +116864,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 139,
-          "end_line": 151,
+          "start_line": 140,
+          "end_line": 152,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for field-level semantic candidate acceptance or manual override."
@@ -115411,8 +116883,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 154,
-          "end_line": 161,
+          "start_line": 155,
+          "end_line": 162,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for thumbs up/down feedback persistence on AI-assisted content."
@@ -115430,8 +116902,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 164,
-          "end_line": 173,
+          "start_line": 165,
+          "end_line": 174,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for submitting one clarification answer."
@@ -115449,8 +116921,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 176,
-          "end_line": 189,
+          "start_line": 177,
+          "end_line": 190,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Summary DTO for current clarification session state without exposing historical noise."
@@ -115468,8 +116940,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 192,
-          "end_line": 200,
+          "start_line": 193,
+          "end_line": 201,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Response DTO for current clarification state and active question payload."
@@ -115487,8 +116959,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 203,
-          "end_line": 212,
+          "start_line": 204,
+          "end_line": 213,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Response DTO for one clarification answer mutation result."
@@ -115506,8 +116978,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 215,
-          "end_line": 223,
+          "start_line": 216,
+          "end_line": 224,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Minimal response DTO for persisted AI feedback actions."
@@ -115525,8 +116997,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 226,
-          "end_line": 233,
+          "start_line": 227,
+          "end_line": 234,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Optional request DTO for explicit mapping approval audit notes."
@@ -115544,8 +117016,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 236,
-          "end_line": 245,
+          "start_line": 237,
+          "end_line": 246,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for one batch semantic-approval item aligned with single-field acceptance semantics."
@@ -115563,8 +117035,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 248,
-          "end_line": 255,
+          "start_line": 249,
+          "end_line": 256,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for explicit batch semantic approvals inside one owned session scope."
@@ -115582,8 +117054,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 258,
-          "end_line": 266,
+          "start_line": 259,
+          "end_line": 267,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for explicit batch mapping approvals aligned with single-item approval semantics."
@@ -115601,8 +117073,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 269,
-          "end_line": 278,
+          "start_line": 270,
+          "end_line": 280,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Contract-compliant async preview trigger response exposing only enqueue state."
@@ -115620,8 +117092,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 281,
-          "end_line": 288,
+          "start_line": 283,
+          "end_line": 290,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Contract-compliant wrapper for execution mapping list responses."
@@ -115639,8 +117111,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 291,
-          "end_line": 303,
+          "start_line": 293,
+          "end_line": 305,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Request DTO for one manual execution-mapping override update without introducing unrelated bulk mutation semantics."
@@ -115658,8 +117130,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 306,
-          "end_line": 314,
+          "start_line": 308,
+          "end_line": 316,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Contract-compliant launch result exposing audited run context and SQL Lab redirect target."
@@ -115677,8 +117149,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 317,
-          "end_line": 331,
+          "start_line": 319,
+          "end_line": 333,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Guard US1 dataset review endpoints behind the configured feature flag."
@@ -115701,8 +117173,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 334,
-          "end_line": 348,
+          "start_line": 336,
+          "end_line": 350,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Guard clarification-specific US2 endpoints behind the configured feature flag."
@@ -115725,8 +117197,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 351,
-          "end_line": 365,
+          "start_line": 353,
+          "end_line": 367,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Guard US3 execution endpoints behind the configured feature flag."
@@ -115749,8 +117221,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 368,
-          "end_line": 375,
+          "start_line": 370,
+          "end_line": 377,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Build repository dependency for dataset review session aggregate access."
@@ -115768,8 +117240,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 378,
-          "end_line": 394,
+          "start_line": 380,
+          "end_line": 396,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Build orchestrator dependency for session lifecycle actions."
@@ -115792,8 +117264,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 397,
-          "end_line": 407,
+          "start_line": 399,
+          "end_line": 409,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Build clarification engine dependency for one-question-at-a-time guided clarification mutations."
@@ -115816,8 +117288,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 410,
-          "end_line": 419,
+          "start_line": 412,
+          "end_line": 423,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Map SQLAlchemy session aggregate root into stable API summary DTO."
@@ -115844,8 +117316,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 422,
-          "end_line": 430,
+          "start_line": 426,
+          "end_line": 436,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Map SQLAlchemy session aggregate root into stable API detail DTO."
@@ -115863,13 +117335,232 @@
             "score": 1.0
           }
         },
+        {
+          "name": "_require_session_version_header",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 439,
+          "end_line": 448,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Read the optimistic-lock session version header required by dataset review mutation endpoints."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_enforce_session_version",
+          "type": "Function",
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 451,
+          "end_line": 476,
+          "tags": {
+            "COMPLEXITY": "4",
+            "PURPOSE": "Convert repository optimistic-lock conflicts into deterministic HTTP 409 responses."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "DatasetReviewSessionRepository"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": false,
+            "issues": [
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 451
+              }
+            ],
+            "score": 0.0
+          }
+        },
+        {
+          "name": "_prepare_owned_session_mutation",
+          "type": "Function",
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 479,
+          "end_line": 493,
+          "tags": {
+            "COMPLEXITY": "4",
+            "PURPOSE": "Resolve owner-scoped mutation session and enforce optimistic-lock version before changing dataset review state."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": false,
+            "issues": [
+              {
+                "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 479
+              }
+            ],
+            "score": 0.0
+          }
+        },
+        {
+          "name": "_commit_owned_session_mutation",
+          "type": "Function",
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 496,
+          "end_line": 514,
+          "tags": {
+            "COMPLEXITY": "4",
+            "PURPOSE": "Centralize dataset-review session version bumping and commit semantics for owner-scoped mutation endpoints."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "DatasetReviewSessionRepository"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": false,
+            "issues": [
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 496
+              }
+            ],
+            "score": 0.0
+          }
+        },
         {
           "name": "_serialize_semantic_field",
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 433,
-          "end_line": 441,
+          "start_line": 517,
+          "end_line": 531,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Map one semantic field aggregate into stable field-level DTO output."
@@ -115892,8 +117583,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 444,
-          "end_line": 471,
+          "start_line": 534,
+          "end_line": 561,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Convert clarification engine payload into API DTO aligned with the clarification contract."
@@ -115916,8 +117607,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 474,
-          "end_line": 497,
+          "start_line": 564,
+          "end_line": 587,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Convert clarification engine state into stable API response payload."
@@ -115935,13 +117626,37 @@
             "score": 1.0
           }
         },
+        {
+          "name": "_serialize_empty_clarification_state",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 590,
+          "end_line": 601,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Return a stable empty clarification payload for sessions that have not started clarification yet."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "ClarificationStateResponse"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "_get_owned_session_or_404",
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 500,
-          "end_line": 526,
+          "start_line": 604,
+          "end_line": 630,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Resolve one session for current user or collaborator scope, returning 404 when inaccessible.",
@@ -115968,8 +117683,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 529,
-          "end_line": 549,
+          "start_line": 633,
+          "end_line": 653,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Enforce owner-only mutation scope for dataset review write endpoints.",
@@ -115991,12 +117706,12 @@
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 529
+                "line_number": 633
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 529
+                "line_number": 633
               }
             ],
             "score": 0.0
@@ -116007,8 +117722,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 552,
-          "end_line": 574,
+          "start_line": 656,
+          "end_line": 678,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Persist one explicit audit event for an owned dataset-review mutation endpoint."
@@ -116031,8 +117746,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 577,
-          "end_line": 597,
+          "start_line": 681,
+          "end_line": 701,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Resolve one execution mapping inside one owned session aggregate without leaking foreign-mapping existence.",
@@ -116054,12 +117769,12 @@
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 577
+                "line_number": 681
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 577
+                "line_number": 681
               }
             ],
             "score": 0.0
@@ -116070,8 +117785,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 600,
-          "end_line": 620,
+          "start_line": 704,
+          "end_line": 724,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Resolve a semantic field inside one owned session aggregate without leaking foreign-field existence.",
@@ -116093,12 +117808,12 @@
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 600
+                "line_number": 704
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 600
+                "line_number": 704
               }
             ],
             "score": 0.0
@@ -116109,8 +117824,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 623,
-          "end_line": 642,
+          "start_line": 727,
+          "end_line": 746,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve the latest clarification aggregate for one session or raise when clarification is unavailable."
@@ -116133,8 +117848,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 645,
-          "end_line": 658,
+          "start_line": 749,
+          "end_line": 762,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Translate accepted semantic candidate type into stable field provenance."
@@ -116152,8 +117867,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 661,
-          "end_line": 680,
+          "start_line": 765,
+          "end_line": 784,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve the semantic source version for one accepted candidate from the loaded session aggregate."
@@ -116180,8 +117895,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 683,
-          "end_line": 761,
+          "start_line": 787,
+          "end_line": 865,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Apply field-level semantic manual override or candidate acceptance while preserving lock/provenance invariants.",
@@ -116207,12 +117922,12 @@
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 683
+                "line_number": 787
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 683
+                "line_number": 787
               }
             ],
             "score": 0.0
@@ -116223,8 +117938,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 764,
-          "end_line": 772,
+          "start_line": 868,
+          "end_line": 882,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Map one persisted execution mapping into stable API DTO output."
@@ -116242,13 +117957,37 @@
             "score": 1.0
           }
         },
+        {
+          "name": "_serialize_preview",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 885,
+          "end_line": 903,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Map one persisted preview snapshot into stable API DTO output and surface the refreshed session version for follow-up optimistic-lock mutations."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "CompiledPreviewDto"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "_serialize_run_context",
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 775,
-          "end_line": 783,
+          "start_line": 906,
+          "end_line": 920,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Map one persisted launch run context into stable API DTO output for SQL Lab handoff confirmation."
@@ -116271,8 +118010,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 786,
-          "end_line": 806,
+          "start_line": 923,
+          "end_line": 943,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Build a stable SQL Lab redirect URL from the configured Superset environment and persisted run context reference."
@@ -116295,8 +118034,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 809,
-          "end_line": 868,
+          "start_line": 946,
+          "end_line": 1005,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Produce session documentation export content from current persisted review state."
@@ -116319,8 +118058,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 871,
-          "end_line": 921,
+          "start_line": 1008,
+          "end_line": 1058,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Produce validation-focused export content from persisted findings and readiness state."
@@ -116343,8 +118082,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 924,
-          "end_line": 956,
+          "start_line": 1061,
+          "end_line": 1093,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "List resumable dataset review sessions for the current user."
@@ -116367,8 +118106,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 959,
-          "end_line": 1007,
+          "start_line": 1096,
+          "end_line": 1144,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Start a new dataset review session from a Superset link or dataset selection.",
@@ -116395,8 +118134,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 1010,
-          "end_line": 1032,
+          "start_line": 1147,
+          "end_line": 1169,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Return the full accessible dataset review session aggregate for current user scope."
@@ -116419,8 +118158,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1035,
-          "end_line": 1084,
+          "start_line": 1172,
+          "end_line": 1228,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Update resumable lifecycle status for an owned dataset review session.",
@@ -116447,8 +118186,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1087,
-          "end_line": 1141,
+          "start_line": 1231,
+          "end_line": 1290,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Archive or hard-delete a session owned by the current user.",
@@ -116475,8 +118214,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1144,
-          "end_line": 1185,
+          "start_line": 1293,
+          "end_line": 1334,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Export documentation output for the current session in JSON or Markdown form.",
@@ -116503,8 +118242,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1188,
-          "end_line": 1229,
+          "start_line": 1337,
+          "end_line": 1378,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Export validation findings for the current session in JSON or Markdown form.",
@@ -116531,13 +118270,13 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1232,
-          "end_line": 1269,
+          "start_line": 1381,
+          "end_line": 1421,
           "tags": {
             "COMPLEXITY": "4",
-            "PURPOSE": "Return the current clarification session summary and one active question payload.",
+            "PURPOSE": "Return the current clarification session summary and one active question payload, or an empty state when clarification has not started.",
             "PRE": "Session is accessible to current user and clarification feature is enabled.",
-            "POST": "Returns at most one active clarification question with why_it_matters, current_guess, and ordered options.",
+            "POST": "Returns at most one active clarification question with why_it_matters, current_guess, and ordered options; sessions without a clarification record return a non-blocking empty state.",
             "SIDE_EFFECT": "May normalize clarification pointer and readiness state in persistence.",
             "DATA_CONTRACT": "Input[session_id:str] -> Output[ClarificationStateResponse]"
           },
@@ -116559,8 +118298,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1272,
-          "end_line": 1310,
+          "start_line": 1424,
+          "end_line": 1464,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Resume clarification mode on the highest-priority unresolved question for an owned session.",
@@ -116587,8 +118326,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1313,
-          "end_line": 1365,
+          "start_line": 1467,
+          "end_line": 1521,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Persist one clarification answer before advancing the active pointer or readiness state.",
@@ -116615,8 +118354,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1368,
-          "end_line": 1415,
+          "start_line": 1524,
+          "end_line": 1574,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Apply one field-level semantic candidate decision or manual override with lock/provenance safeguards.",
@@ -116643,8 +118382,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1418,
-          "end_line": 1459,
+          "start_line": 1577,
+          "end_line": 1623,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Lock one semantic field against later automatic overwrite while preserving the current active value.",
@@ -116671,8 +118410,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1462,
-          "end_line": 1506,
+          "start_line": 1626,
+          "end_line": 1675,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Unlock one semantic field so later automated candidate application may replace it explicitly.",
@@ -116699,8 +118438,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1509,
-          "end_line": 1564,
+          "start_line": 1678,
+          "end_line": 1737,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Approve multiple semantic candidate decisions in one owner-authorized batch without bypassing single-field semantics.",
@@ -116727,8 +118466,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1567,
-          "end_line": 1599,
+          "start_line": 1740,
+          "end_line": 1772,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Return the current mapping-review set for one accessible session.",
@@ -116755,8 +118494,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1602,
-          "end_line": 1677,
+          "start_line": 1775,
+          "end_line": 1853,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Persist one owner-authorized execution-mapping effective value override and invalidate stale preview truth.",
@@ -116783,8 +118522,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1680,
-          "end_line": 1732,
+          "start_line": 1856,
+          "end_line": 1911,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Explicitly approve a warning-sensitive mapping transformation and preserve audit note state.",
@@ -116811,8 +118550,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1735,
-          "end_line": 1793,
+          "start_line": 1914,
+          "end_line": 1976,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Approve multiple warning-sensitive execution mappings in one owner-authorized batch.",
@@ -116839,8 +118578,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1796,
-          "end_line": 1850,
+          "start_line": 1979,
+          "end_line": 2043,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Trigger Superset-side preview compilation for the current owned execution context.",
@@ -116867,8 +118606,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1853,
-          "end_line": 1909,
+          "start_line": 2046,
+          "end_line": 2108,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Execute the current owned session launch handoff through the orchestrator and return audited SQL Lab run context.",
@@ -116895,8 +118634,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1912,
-          "end_line": 1952,
+          "start_line": 2111,
+          "end_line": 2158,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Persist thumbs up/down feedback for AI-assisted semantic field content.",
@@ -116923,8 +118662,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1955,
-          "end_line": 2019,
+          "start_line": 2161,
+          "end_line": 2229,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Persist thumbs up/down feedback for clarification question/answer content used in guided review.",
@@ -116951,7 +118690,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 2021 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 2231 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -117241,30 +118980,51 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 32,
+      "end_line": 39,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "api, router, plugins, list",
         "PURPOSE": "Defines the FastAPI router for plugin-related endpoints, allowing clients to list available plugins.",
-        "LAYER": "UI (API)",
-        "RELATION": "Depends on the PluginLoader and PluginConfig. It is included by the main app."
+        "LAYER": "UI (API)"
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "PluginConfig"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "get_plugin_loader"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "API_Routes"
+        }
+      ],
       "children": [
         {
           "name": "list_plugins",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 16,
-          "end_line": 31,
+          "start_line": 19,
+          "end_line": 38,
           "tags": {
             "PURPOSE": "Retrieve a list of all available plugins.",
             "PRE": "plugin_loader is injected via Depends.",
             "POST": "Returns a list of PluginConfig objects.",
             "RETURN": "List[PluginConfig] - List of registered plugins."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "get_plugin_loader"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "PluginConfig"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -117276,7 +119036,7 @@
       "compliance": {
         "valid": true,
         "issues": [],
-        "score": 1.0
+        "score": 0.925
       }
     },
     {
@@ -117285,46 +119045,47 @@
       "complexity": 4,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 328,
+      "end_line": 332,
       "tags": {
         "COMPLEXITY": "4",
-        "PURPOSE": "Redesigned clean release API for headless candidate lifecycle."
+        "PURPOSE": "Redesigned clean release API for headless candidate lifecycle.",
+        "LAYER": "UI (API)",
+        "PRE": "Clean release repository dependency is available for candidate lifecycle endpoints.",
+        "POST": "Candidate registration, approval, publication, and revocation routes are registered without behavior changes.",
+        "SIDE_EFFECT": "Persists candidate lifecycle state through clean release services and repository adapters."
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "DEPENDS_ON",
+          "target": "CleanReleaseRepository"
+        },
+        {
+          "type": "CALLS",
+          "target": "approve_candidate"
+        },
+        {
+          "type": "CALLS",
+          "target": "publish_candidate"
+        }
+      ],
       "children": [
         {
           "name": "ApprovalRequest",
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 29,
-          "end_line": 37,
+          "start_line": 36,
+          "end_line": 43,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Schema for approval request payload."
           },
-          "relations": [
-            {
-              "type": "USES",
-              "target": "CandidateDTO"
-            }
-          ],
+          "relations": [],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 29
-              },
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 29
-              }
-            ],
-            "score": 0.7
+            "issues": [],
+            "score": 1.0
           }
         },
         {
@@ -117332,34 +119093,18 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 40,
-          "end_line": 48,
+          "start_line": 46,
+          "end_line": 53,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Schema for publication request payload."
           },
-          "relations": [
-            {
-              "type": "USES",
-              "target": "CandidateDTO"
-            }
-          ],
+          "relations": [],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 40
-              },
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 40
-              }
-            ],
-            "score": 0.7
+            "issues": [],
+            "score": 1.0
           }
         },
         {
@@ -117367,34 +119112,18 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 51,
-          "end_line": 59,
+          "start_line": 56,
+          "end_line": 63,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Schema for revocation request payload."
           },
-          "relations": [
-            {
-              "type": "USES",
-              "target": "CandidateDTO"
-            }
-          ],
+          "relations": [],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 51
-              },
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 51
-              }
-            ],
-            "score": 0.7
+            "issues": [],
+            "score": 1.0
           }
         },
         {
@@ -117402,8 +119131,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 62,
-          "end_line": 96,
+          "start_line": 66,
+          "end_line": 100,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Register a new release candidate.",
@@ -117417,26 +119146,15 @@
               "target": "CleanReleaseRepository.save_candidate"
             },
             {
-              "type": "USES",
+              "type": "DEPENDS_ON",
               "target": "CandidateDTO"
             }
           ],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 62
-              },
-              {
-                "message": "Invalid @RELATION predicate: USES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-                "severity": "WARNING",
-                "line_number": 62
-              }
-            ],
-            "score": 0.5499999999999999
+            "issues": [],
+            "score": 0.85
           }
         },
         {
@@ -117444,8 +119162,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 99,
-          "end_line": 130,
+          "start_line": 103,
+          "end_line": 134,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Associate artifacts with a release candidate.",
@@ -117470,8 +119188,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 133,
-          "end_line": 180,
+          "start_line": 137,
+          "end_line": 184,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Generate distribution manifest for a candidate.",
@@ -117501,8 +119219,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 183,
-          "end_line": 209,
+          "start_line": 187,
+          "end_line": 213,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Endpoint to record candidate approval."
@@ -117525,8 +119243,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 212,
-          "end_line": 238,
+          "start_line": 216,
+          "end_line": 242,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Endpoint to record candidate rejection."
@@ -117549,8 +119267,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 241,
-          "end_line": 283,
+          "start_line": 245,
+          "end_line": 287,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Endpoint to publish an approved candidate."
@@ -117573,8 +119291,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 286,
-          "end_line": 326,
+          "start_line": 290,
+          "end_line": 330,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Endpoint to revoke a previous publication."
@@ -117596,43 +119314,18 @@
       "compliance": {
         "valid": false,
         "issues": [
-          {
-            "message": "Missing Mandatory Tag: @LAYER (required for complexity 4)",
-            "severity": "ERROR",
-            "line_number": 1
-          },
           {
             "message": "Missing Mandatory Tag: @SEMANTICS (required for complexity 4)",
             "severity": "ERROR",
             "line_number": 1
           },
           {
-            "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
-            "severity": "ERROR",
-            "line_number": 1
-          },
-          {
-            "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
-            "severity": "ERROR",
-            "line_number": 1
-          },
-          {
-            "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
-            "severity": "ERROR",
-            "line_number": 1
-          },
-          {
-            "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
-            "severity": "ERROR",
-            "line_number": 1
-          },
-          {
-            "message": "Fractal limit warning: Module length is 328 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 332 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
         ],
-        "score": 0.0
+        "score": 0.2642857142857143
       }
     },
     {
@@ -119217,7 +120910,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 2694,
+      "end_line": 3396,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "api, assistant, chat, command, confirmation",
@@ -119249,8 +120942,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 56,
-          "end_line": 70,
+          "start_line": 75,
+          "end_line": 90,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Input payload for assistant message endpoint.",
@@ -119273,12 +120966,12 @@
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 56
+                "line_number": 75
               },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 56
+                "line_number": 75
               }
             ],
             "score": 0.7
@@ -119289,8 +120982,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 73,
-          "end_line": 88,
+          "start_line": 93,
+          "end_line": 108,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "UI action descriptor returned with assistant responses.",
@@ -119313,12 +121006,12 @@
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 73
+                "line_number": 93
               },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 73
+                "line_number": 93
               }
             ],
             "score": 0.7
@@ -119329,8 +121022,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 91,
-          "end_line": 114,
+          "start_line": 111,
+          "end_line": 134,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Output payload contract for assistant interaction endpoints.",
@@ -119361,32 +121054,32 @@
               {
                 "message": "Invalid @RELATION predicate: RETURNED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 91
+                "line_number": 111
               },
               {
                 "message": "Invalid @RELATION predicate: RETURNED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 91
+                "line_number": 111
               },
               {
                 "message": "Invalid @RELATION predicate: RETURNED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 91
+                "line_number": 111
               },
               {
                 "message": "Invalid @RELATION predicate: RETURNED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 91
+                "line_number": 111
               },
               {
                 "message": "Invalid @RELATION predicate: RETURNED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 91
+                "line_number": 111
               },
               {
                 "message": "Invalid @RELATION predicate: RETURNED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 91
+                "line_number": 111
               }
             ],
             "score": 0.10000000000000009
@@ -119397,8 +121090,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 117,
-          "end_line": 139,
+          "start_line": 137,
+          "end_line": 159,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "In-memory confirmation token model for risky operation dispatch.",
@@ -119429,32 +121122,32 @@
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 117
+                "line_number": 137
               },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 117
+                "line_number": 137
               },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 117
+                "line_number": 137
               },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 117
+                "line_number": 137
               },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 117
+                "line_number": 137
               },
               {
                 "message": "Invalid @RELATION predicate: USED_BY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 117
+                "line_number": 137
               }
             ],
             "score": 0.10000000000000009
@@ -119465,8 +121158,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 165,
-          "end_line": 200,
+          "start_line": 189,
+          "end_line": 224,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Append conversation message to in-memory history buffer.",
@@ -119489,12 +121182,12 @@
               {
                 "message": "Invalid @RELATION predicate: UPDATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 165
+                "line_number": 189
               },
               {
                 "message": "Invalid @RELATION predicate: UPDATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 165
+                "line_number": 189
               }
             ],
             "score": 0.7
@@ -119505,8 +121198,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 203,
-          "end_line": 242,
+          "start_line": 227,
+          "end_line": 266,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Persist assistant/user message record to database.",
@@ -119534,8 +121227,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 245,
-          "end_line": 263,
+          "start_line": 269,
+          "end_line": 287,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Append in-memory audit record for assistant decision trace.",
@@ -119558,12 +121251,12 @@
               {
                 "message": "Invalid @RELATION predicate: UPDATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 245
+                "line_number": 269
               },
               {
                 "message": "Invalid @RELATION predicate: UPDATES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "WARNING",
-                "line_number": 245
+                "line_number": 269
               }
             ],
             "score": 0.7
@@ -119574,8 +121267,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 266,
-          "end_line": 291,
+          "start_line": 290,
+          "end_line": 315,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Persist structured assistant audit payload in database.",
@@ -119595,8 +121288,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 294,
-          "end_line": 319,
+          "start_line": 318,
+          "end_line": 343,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Persist confirmation token record to database.",
@@ -119616,8 +121309,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 322,
-          "end_line": 345,
+          "start_line": 346,
+          "end_line": 369,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Update persistent confirmation token lifecycle state.",
@@ -119637,8 +121330,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 348,
-          "end_line": 375,
+          "start_line": 372,
+          "end_line": 399,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Load confirmation token from database into in-memory model.",
@@ -119658,8 +121351,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 378,
-          "end_line": 397,
+          "start_line": 402,
+          "end_line": 421,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve active conversation id in memory or create a new one.",
@@ -119679,8 +121372,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 400,
-          "end_line": 431,
+          "start_line": 424,
+          "end_line": 455,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve active conversation using explicit id, memory cache, or persisted history.",
@@ -119700,8 +121393,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 434,
-          "end_line": 473,
+          "start_line": 458,
+          "end_line": 497,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Enforce assistant message retention window by deleting expired rows and in-memory records.",
@@ -119721,8 +121414,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 476,
-          "end_line": 488,
+          "start_line": 500,
+          "end_line": 512,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Determine archived state for a conversation based on last update timestamp.",
@@ -119742,8 +121435,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 491,
-          "end_line": 504,
+          "start_line": 515,
+          "end_line": 528,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Normalize bool-like query values for compatibility in direct handler invocations/tests.",
@@ -119763,8 +121456,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 507,
-          "end_line": 520,
+          "start_line": 531,
+          "end_line": 544,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Extract first regex match group from text by ordered pattern list.",
@@ -119784,8 +121477,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 523,
-          "end_line": 542,
+          "start_line": 547,
+          "end_line": 566,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve environment identifier/name token to canonical environment id.",
@@ -119805,8 +121498,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 545,
-          "end_line": 562,
+          "start_line": 569,
+          "end_line": 586,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Determine whether environment token resolves to production-like target.",
@@ -119826,8 +121519,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 565,
-          "end_line": 600,
+          "start_line": 589,
+          "end_line": 624,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve provider token to provider id with active/default fallback.",
@@ -119847,8 +121540,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 603,
-          "end_line": 626,
+          "start_line": 627,
+          "end_line": 650,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve default environment id from settings or first configured environment.",
@@ -119868,8 +121561,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 629,
-          "end_line": 680,
+          "start_line": 653,
+          "end_line": 704,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve dashboard id by title or slug reference in selected environment.",
@@ -119889,8 +121582,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 683,
-          "end_line": 723,
+          "start_line": 707,
+          "end_line": 747,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve dashboard id from intent entities using numeric id or dashboard_ref fallback.",
@@ -119910,8 +121603,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 726,
-          "end_line": 742,
+          "start_line": 750,
+          "end_line": 766,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve human-readable environment name by id.",
@@ -119931,8 +121624,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 745,
-          "end_line": 815,
+          "start_line": 769,
+          "end_line": 839,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Build deep-link actions to verify task result from assistant chat.",
@@ -119952,8 +121645,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 818,
-          "end_line": 883,
+          "start_line": 842,
+          "end_line": 907,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Build compact textual summary for completed tasks to reduce \"black box\" effect.",
@@ -119973,8 +121666,8 @@
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 886,
-          "end_line": 1093,
+          "start_line": 910,
+          "end_line": 1117,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Deterministically parse RU/EN command text into intent payload.",
@@ -120001,12 +121694,12 @@
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 886
+                "line_number": 910
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 886
+                "line_number": 910
               }
             ],
             "score": 0.0
@@ -120017,8 +121710,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 1096,
-          "end_line": 1117,
+          "start_line": 1120,
+          "end_line": 1141,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Validate user against alternative permission checks (logical OR).",
@@ -120038,8 +121731,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 1120,
-          "end_line": 1133,
+          "start_line": 1144,
+          "end_line": 1157,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Check whether user has at least one permission tuple from the provided list.",
@@ -120059,8 +121752,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 1136,
-          "end_line": 1277,
+          "start_line": 1160,
+          "end_line": 1359,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Build current-user tool catalog for LLM planner with operation contracts and defaults.",
@@ -120075,12 +121768,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 1136
+                "line_number": 1160
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 1136
+                "line_number": 1160
               }
             ],
             "score": 0.5499999999999999
@@ -120091,8 +121784,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 1280,
-          "end_line": 1300,
+          "start_line": 1362,
+          "end_line": 1382,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Normalize intent entity value types from LLM output to route-compatible values.",
@@ -120107,13 +121800,309 @@
             "score": 1.0
           }
         },
+        {
+          "name": "_serialize_dataset_review_context",
+          "type": "Function",
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 1400,
+          "end_line": 1504,
+          "tags": {
+            "COMPLEXITY": "4",
+            "PURPOSE": "Build assistant-safe dataset-review context snapshot with masked imported-filter payloads for session-scoped assistant routing."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "DatasetReviewSession"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": false,
+            "issues": [
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1400
+              }
+            ],
+            "score": 0.0
+          }
+        },
+        {
+          "name": "_load_dataset_review_context",
+          "type": "Function",
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 1507,
+          "end_line": 1525,
+          "tags": {
+            "COMPLEXITY": "4",
+            "PURPOSE": "Load owner-scoped dataset-review context for assistant planning and grounded response generation."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "DatasetReviewSessionRepository"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": false,
+            "issues": [
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              },
+              {
+                "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1507
+              }
+            ],
+            "score": 0.0
+          }
+        },
+        {
+          "name": "_extract_dataset_review_target",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 1528,
+          "end_line": 1542,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Extract structured dataset-review focus target hints embedded in assistant prompts."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_match_dataset_review_field",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 1545,
+          "end_line": 1573,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Resolve one semantic field from assistant-visible context by id or user-visible label."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_extract_quoted_segment",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 1576,
+          "end_line": 1585,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Extract one quoted assistant command segment after a label token."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_dataset_review_conflict_http_exception",
+          "type": "Function",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 1588,
+          "end_line": 1606,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Convert dataset-review optimistic-lock conflicts into shared 409 assistant semantics."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_plan_dataset_review_intent",
+          "type": "Function",
+          "complexity": 3,
+          "tier": "STANDARD",
+          "start_line": 1609,
+          "end_line": 1760,
+          "tags": {
+            "COMPLEXITY": "3",
+            "PURPOSE": "Parse session-scoped dataset-review assistant commands before falling back to generic assistant tool routing."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [
+              {
+                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
+                "severity": "WARNING",
+                "line_number": 1609
+              },
+              {
+                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
+                "severity": "WARNING",
+                "line_number": 1609
+              }
+            ],
+            "score": 0.5499999999999999
+          }
+        },
+        {
+          "name": "_dispatch_dataset_review_intent",
+          "type": "Function",
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 1763,
+          "end_line": 1981,
+          "tags": {
+            "COMPLEXITY": "4",
+            "PURPOSE": "Route confirmed dataset-review assistant intents through existing backend dataset-review APIs and orchestration boundaries."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": false,
+            "issues": [
+              {
+                "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              },
+              {
+                "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              },
+              {
+                "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              },
+              {
+                "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              },
+              {
+                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
+                "severity": "ERROR",
+                "line_number": 1763
+              }
+            ],
+            "score": 0.0
+          }
+        },
         {
           "name": "_confirmation_summary",
           "type": "Function",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 1307,
-          "end_line": 1447,
+          "start_line": 1984,
+          "end_line": 2124,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Build human-readable confirmation prompt for an intent before execution.",
@@ -120128,32 +122117,32 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 1307
+                "line_number": 1984
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 1307
+                "line_number": 1984
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 1307
+                "line_number": 1984
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 1307
+                "line_number": 1984
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 1307
+                "line_number": 1984
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                 "severity": "ERROR",
-                "line_number": 1307
+                "line_number": 1984
               }
             ],
             "score": 0.0
@@ -120164,8 +122153,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 1450,
-          "end_line": 1475,
+          "start_line": 2127,
+          "end_line": 2152,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Convert technical missing-parameter errors into user-facing clarification prompts.",
@@ -120185,8 +122174,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 1478,
-          "end_line": 1597,
+          "start_line": 2155,
+          "end_line": 2274,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Use active LLM provider to select best tool/operation from dynamic catalog.",
@@ -120206,8 +122195,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 1600,
-          "end_line": 1611,
+          "start_line": 2277,
+          "end_line": 2288,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Validate user permissions for parsed intent before confirmation/dispatch.",
@@ -120227,8 +122216,8 @@
           "type": "Function",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 1614,
-          "end_line": 2016,
+          "start_line": 2291,
+          "end_line": 2701,
           "tags": {
             "COMPLEXITY": "5",
             "PURPOSE": "Execute parsed assistant intent via existing task/plugin/git services.",
@@ -120263,12 +122252,12 @@
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 1614
+                "line_number": 2291
               },
               {
                 "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 1614
+                "line_number": 2291
               }
             ],
             "score": 0.0
@@ -120279,8 +122268,8 @@
           "type": "Function",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 2020,
-          "end_line": 2265,
+          "start_line": 2705,
+          "end_line": 2967,
           "tags": {
             "COMPLEXITY": "5",
             "PURPOSE": "Parse assistant command, enforce safety gates, and dispatch executable intent.",
@@ -120329,8 +122318,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 2271,
-          "end_line": 2354,
+          "start_line": 2973,
+          "end_line": 3056,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Execute previously requested risky operation after explicit user confirmation.",
@@ -120351,8 +122340,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 2360,
-          "end_line": 2431,
+          "start_line": 3062,
+          "end_line": 3133,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Cancel pending risky operation and mark confirmation token as cancelled.",
@@ -120373,8 +122362,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 2434,
-          "end_line": 2529,
+          "start_line": 3136,
+          "end_line": 3231,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Return paginated conversation list for current user with archived flag and last message preview.",
@@ -120395,8 +122384,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 2532,
-          "end_line": 2575,
+          "start_line": 3234,
+          "end_line": 3277,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Soft-delete or hard-delete a conversation and clear its in-memory trace.",
@@ -120416,8 +122405,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 2579,
-          "end_line": 2647,
+          "start_line": 3281,
+          "end_line": 3349,
           "tags": {
             "PURPOSE": "Retrieve paginated assistant conversation history for current user.",
             "PRE": "Authenticated user is available and page params are valid.",
@@ -120437,8 +122426,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 2651,
-          "end_line": 2692,
+          "start_line": 3353,
+          "end_line": 3394,
           "tags": {
             "PURPOSE": "Return assistant audit decisions for current user from persistent and in-memory stores.",
             "PRE": "User has tasks:READ permission.",
@@ -120458,8 +122447,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1312,
-          "end_line": 1312,
+          "start_line": 1989,
+          "end_line": 1989,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -120477,8 +122466,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1330,
-          "end_line": 1330,
+          "start_line": 2007,
+          "end_line": 2007,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -120516,7 +122505,7 @@
             "line_number": 1
           },
           {
-            "message": "Fractal limit warning: Module length is 2694 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 3396 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -121025,7 +123014,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 185,
+      "end_line": 187,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "api, reports, list, detail, pagination, filters",
@@ -121062,7 +123051,7 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 43,
-          "end_line": 77,
+          "end_line": 78,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Parse comma-separated query value into enum list.",
@@ -121071,7 +123060,12 @@
             "PARAM": "field_name (str) - Query field name for diagnostics.",
             "RETURN": "List - Parsed enum values."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "ReportsRouter"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121084,8 +123078,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 80,
-          "end_line": 153,
+          "start_line": 81,
+          "end_line": 154,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Return paginated unified reports list.",
@@ -121122,15 +123116,20 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 156,
-          "end_line": 183,
+          "start_line": 157,
+          "end_line": 185,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Return one normalized report detail with diagnostics and next actions.",
             "PRE": "authenticated/authorized request and existing report_id.",
             "POST": "returns normalized detail envelope or 404 when report is not found."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "ReportsService:Class"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121311,7 +123310,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 24,
+      "end_line": 59,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "routes, lazy-import, module-registry",
@@ -121323,16 +123322,64 @@
         {
           "type": "CALLS",
           "target": "ApiRoutesGetAttr"
+        },
+        {
+          "type": "BINDS_TO",
+          "target": "Route_Group_Contracts"
         }
       ],
       "children": [
+        {
+          "name": "Route_Group_Contracts",
+          "type": "Block",
+          "complexity": 3,
+          "tier": "STANDARD",
+          "start_line": 10,
+          "end_line": 41,
+          "tags": {
+            "COMPLEXITY": "3",
+            "PURPOSE": "Declare the canonical route-module registry used by lazy imports and app router inclusion."
+          },
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "PluginsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "TasksRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "SettingsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ConnectionsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ReportsRouter"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LlmRoutes"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "ApiRoutesGetAttr",
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 12,
-          "end_line": 23,
+          "start_line": 44,
+          "end_line": 58,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Lazily import route module by attribute name.",
@@ -121357,8 +123404,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 18,
-          "end_line": 18,
+          "start_line": 50,
+          "end_line": 50,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -121384,7 +123431,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 337,
+      "end_line": 423,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "api, router, tasks, create, list, get, logs",
@@ -121411,8 +123458,8 @@
           "type": "Function",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 45,
-          "end_line": 107,
+          "start_line": 54,
+          "end_line": 134,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Create and start a new task for a given plugin.",
@@ -121421,23 +123468,25 @@
             "POST": "A new task is created and started.",
             "RETURN": "Task - The created task instance."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ConfigManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMProviderService"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                "severity": "WARNING",
-                "line_number": 45
-              },
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                "severity": "WARNING",
-                "line_number": 45
-              }
-            ],
-            "score": 0.5499999999999999
+            "issues": [],
+            "score": 0.85
           }
         },
         {
@@ -121445,8 +123494,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 109,
-          "end_line": 147,
+          "start_line": 137,
+          "end_line": 185,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Retrieve a list of tasks with pagination and optional status filter.",
@@ -121455,7 +123504,16 @@
             "POST": "Returns a list of tasks.",
             "RETURN": "List[Task] - List of tasks."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            },
+            {
+              "type": "BINDS_TO",
+              "target": "TASK_TYPE_PLUGIN_MAP"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121468,8 +123526,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 149,
-          "end_line": 168,
+          "start_line": 188,
+          "end_line": 212,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Retrieve the details of a specific task.",
@@ -121478,7 +123536,12 @@
             "POST": "Returns task details or raises 404.",
             "RETURN": "Task - The task details."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121491,8 +123554,8 @@
           "type": "Function",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 170,
-          "end_line": 213,
+          "start_line": 215,
+          "end_line": 268,
           "tags": {
             "COMPLEXITY": "5",
             "PURPOSE": "Retrieve logs for a specific task with optional filtering.",
@@ -121506,40 +123569,39 @@
             "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]"
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LogFilter"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": false,
             "issues": [
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 170
-              },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 170
+                "line_number": 215
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 170
-              },
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 170
+                "line_number": 215
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 170
+                "line_number": 215
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 170
+                "line_number": 215
               }
             ],
             "score": 0.0
@@ -121550,8 +123612,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 215,
-          "end_line": 249,
+          "start_line": 271,
+          "end_line": 317,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Get statistics about logs for a task (counts by level and source).",
@@ -121560,7 +123622,16 @@
             "POST": "Returns log statistics or raises 404.",
             "RETURN": "LogStats - Statistics about task logs."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LogStats"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121573,8 +123644,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 251,
-          "end_line": 269,
+          "start_line": 320,
+          "end_line": 343,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Get unique sources for a task's logs.",
@@ -121583,7 +123654,12 @@
             "POST": "Returns list of unique source names or raises 404.",
             "RETURN": "List[str] - Unique source names."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121596,8 +123672,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 271,
-          "end_line": 293,
+          "start_line": 346,
+          "end_line": 371,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resolve a task that is awaiting mapping.",
@@ -121606,7 +123682,12 @@
             "POST": "Task is resolved and resumes execution.",
             "RETURN": "Task - The updated task object."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121619,8 +123700,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 295,
-          "end_line": 317,
+          "start_line": 374,
+          "end_line": 399,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Resume a task that is awaiting input (e.g., passwords).",
@@ -121629,7 +123710,12 @@
             "POST": "Task resumes execution with provided input.",
             "RETURN": "Task - The updated task object."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121642,8 +123728,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 319,
-          "end_line": 335,
+          "start_line": 402,
+          "end_line": 421,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Clear tasks matching the status filter.",
@@ -121651,7 +123737,12 @@
             "PRE": "task_manager is available.",
             "POST": "Tasks are removed from memory/persistence."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "TaskManager"
+            }
+          ],
           "children": [],
           "compliance": {
             "valid": true,
@@ -121664,7 +123755,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 337 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 423 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -126114,7 +128205,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 1503,
+      "end_line": 1728,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "dataset_review, api, tests, lifecycle, exports, orchestration",
@@ -126137,8 +128228,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 73,
-          "end_line": 87,
+          "start_line": 76,
+          "end_line": 90,
           "tags": {},
           "relations": [
             {
@@ -126158,8 +128249,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 90,
-          "end_line": 109,
+          "start_line": 93,
+          "end_line": 112,
           "tags": {},
           "relations": [
             {
@@ -126179,8 +128270,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 112,
-          "end_line": 135,
+          "start_line": 115,
+          "end_line": 139,
           "tags": {},
           "relations": [
             {
@@ -126200,8 +128291,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 138,
-          "end_line": 253,
+          "start_line": 142,
+          "end_line": 257,
           "tags": {},
           "relations": [
             {
@@ -126221,8 +128312,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 256,
-          "end_line": 323,
+          "start_line": 260,
+          "end_line": 327,
           "tags": {
             "RISK": "No spec= guard \u2014 enum/field contract changes are undetectable at test time."
           },
@@ -126244,8 +128335,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 326,
-          "end_line": 336,
+          "start_line": 330,
+          "end_line": 340,
           "tags": {},
           "relations": [
             {
@@ -126265,8 +128356,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 339,
-          "end_line": 359,
+          "start_line": 343,
+          "end_line": 363,
           "tags": {},
           "relations": [
             {
@@ -126286,8 +128377,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 362,
-          "end_line": 396,
+          "start_line": 366,
+          "end_line": 400,
           "tags": {
             "PURPOSE": "Verify dashboard links recover dataset context and preserve explicit partial-recovery markers."
           },
@@ -126309,8 +128400,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 399,
-          "end_line": 433,
+          "start_line": 403,
+          "end_line": 437,
           "tags": {
             "PURPOSE": "Verify dashboard slug links resolve through dashboard detail endpoints and recover dataset context."
           },
@@ -126332,8 +128423,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 436,
-          "end_line": 528,
+          "start_line": 440,
+          "end_line": 532,
           "tags": {
             "PURPOSE": "Verify dashboard permalink links no longer fail parsing and preserve permalink filter state for partial recovery."
           },
@@ -126349,8 +128440,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 483,
-              "end_line": 527,
+              "start_line": 487,
+              "end_line": 531,
               "tags": {
                 "PURPOSE": "Verify permalink state with nested dashboard id recovers dataset binding and keeps imported filters."
               },
@@ -126379,8 +128470,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 531,
-          "end_line": 573,
+          "start_line": 535,
+          "end_line": 577,
           "tags": {
             "PURPOSE": "Verify trusted dictionary exact matches outrank fuzzy candidates and unresolved fields stay explicit."
           },
@@ -126402,8 +128493,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 576,
-          "end_line": 641,
+          "start_line": 580,
+          "end_line": 645,
           "tags": {
             "PURPOSE": "Verify session start persists usable recovery-required state when Superset intake is partial."
           },
@@ -126425,8 +128516,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 644,
-          "end_line": 749,
+          "start_line": 648,
+          "end_line": 753,
           "tags": {
             "PURPOSE": "Verify session start persists recovered filters, template variables, and initial execution mappings for review workspace bootstrap."
           },
@@ -126448,8 +128539,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 752,
-          "end_line": 782,
+          "start_line": 756,
+          "end_line": 786,
           "tags": {
             "PURPOSE": "Verify POST session lifecycle endpoint returns a persisted ownership-scoped summary."
           },
@@ -126471,8 +128562,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 785,
-          "end_line": 892,
+          "start_line": 789,
+          "end_line": 904,
           "tags": {
             "PURPOSE": "Verify lifecycle get/patch/delete plus documentation and validation exports remain ownership-scoped and usable."
           },
@@ -126489,13 +128580,31 @@
             "score": 1.0
           }
         },
+        {
+          "name": "test_get_clarification_state_returns_empty_payload_when_session_has_no_record",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 907,
+          "end_line": 927,
+          "tags": {
+            "PURPOSE": "Clarification state endpoint should return a non-blocking empty payload when the session has no clarification aggregate yet."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "test_us2_clarification_endpoints_persist_answer_and_feedback",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 895,
-          "end_line": 956,
+          "start_line": 930,
+          "end_line": 994,
           "tags": {
             "PURPOSE": "Clarification endpoints should expose one current question, persist the answer before advancement, and store feedback on the answer audit record."
           },
@@ -126517,8 +128626,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 959,
-          "end_line": 1029,
+          "start_line": 997,
+          "end_line": 1076,
           "tags": {
             "PURPOSE": "Semantic field endpoints should apply manual overrides with lock/provenance invariants and persist feedback independently."
           },
@@ -126540,8 +128649,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1032,
-          "end_line": 1201,
+          "start_line": 1079,
+          "end_line": 1284,
           "tags": {
             "PURPOSE": "US3 execution endpoints should persist manual overrides, preserve explicit approval semantics, return contract-shaped preview truth, and expose audited launch handoff."
           },
@@ -126558,13 +128667,36 @@
             "score": 1.0
           }
         },
+        {
+          "name": "test_us3_preview_response_propagates_refreshed_session_version_for_launch_follow_up",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1287,
+          "end_line": 1383,
+          "tags": {
+            "PURPOSE": "Preview response should expose the refreshed session version so the normal preview-then-launch UI flow can satisfy optimistic locking without a forced full reload."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "DatasetReviewApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "test_us3_preview_endpoint_returns_failed_preview_without_false_dashboard_not_found_contract_drift",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1204,
-          "end_line": 1252,
+          "start_line": 1386,
+          "end_line": 1437,
           "tags": {
             "PURPOSE": "Preview endpoint should preserve API contract and surface generic upstream preview failures without fabricating dashboard-not-found semantics for non-dashboard 404s."
           },
@@ -126581,13 +128713,36 @@
             "score": 1.0
           }
         },
+        {
+          "name": "test_mutation_endpoints_surface_session_version_conflict_payload",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1440,
+          "end_line": 1477,
+          "tags": {
+            "PURPOSE": "Dataset review mutation endpoints should return deterministic 409 conflict semantics when optimistic-lock versions are stale."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "DatasetReviewApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "test_execution_snapshot_includes_recovered_imported_filters_without_template_mapping",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1255,
-          "end_line": 1325,
+          "start_line": 1480,
+          "end_line": 1550,
           "tags": {
             "PURPOSE": "Recovered imported filters with values should flow into preview filter context even when no template variable mapping exists."
           },
@@ -126609,8 +128764,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1328,
-          "end_line": 1364,
+          "start_line": 1553,
+          "end_line": 1589,
           "tags": {
             "PURPOSE": "Mapped template variables should still populate template params while contributing their effective filter context."
           },
@@ -126632,8 +128787,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1367,
-          "end_line": 1406,
+          "start_line": 1592,
+          "end_line": 1631,
           "tags": {
             "PURPOSE": "Partial imported filters without raw or normalized values must not emit bogus active preview filters."
           },
@@ -126655,8 +128810,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1409,
-          "end_line": 1462,
+          "start_line": 1634,
+          "end_line": 1687,
           "tags": {
             "PURPOSE": "Launch endpoint should enforce the contract RBAC permission instead of the generic session-manage permission."
           },
@@ -126678,8 +128833,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 1465,
-          "end_line": 1501,
+          "start_line": 1690,
+          "end_line": 1726,
           "tags": {
             "PURPOSE": "Updated semantic source versions should mark unlocked fields reviewable while preserving locked manual values."
           },
@@ -126701,8 +128856,122 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 908,
-          "end_line": 908,
+          "start_line": 944,
+          "end_line": 944,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_assert_expected_preview_version",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1154,
+          "end_line": 1154,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_assert_expected_launch_version",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1160,
+          "end_line": 1160,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_assert_expected_pending_preview_version",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1235,
+          "end_line": 1235,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_require_session_version",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1299,
+          "end_line": 1299,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_prepare_preview",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1342,
+          "end_line": 1342,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_launch_dataset",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 1351,
+          "end_line": 1351,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -126720,7 +128989,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 1503 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 1728 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -129354,7 +131623,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 4,
-      "end_line": 293,
+      "end_line": 564,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "tests, assistant, api",
@@ -129374,8 +131643,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 26,
-          "end_line": 32,
+          "start_line": 40,
+          "end_line": 46,
           "tags": {},
           "relations": [
             {
@@ -129395,8 +131664,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 35,
-          "end_line": 60,
+          "start_line": 49,
+          "end_line": 74,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Lightweight task model stub used as return value from _FakeTaskManager.create_task in assistant route tests.",
@@ -129420,8 +131689,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 64,
-          "end_line": 97,
+          "start_line": 78,
+          "end_line": 111,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "In-memory task manager stub that records created tasks for route-level assertions.",
@@ -129445,8 +131714,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 100,
-          "end_line": 126,
+          "start_line": 114,
+          "end_line": 140,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Deterministic config stub providing hardcoded dev/prod environments and minimal settings shape for assistant route tests.",
@@ -129470,8 +131739,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 129,
-          "end_line": 143,
+          "start_line": 143,
+          "end_line": 157,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Build admin principal with spec=User for assistant route authorization tests."
@@ -129494,8 +131763,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 146,
-          "end_line": 158,
+          "start_line": 160,
+          "end_line": 172,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Build limited user principal with empty roles for assistant route denial tests."
@@ -129518,8 +131787,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 161,
-          "end_line": 195,
+          "start_line": 175,
+          "end_line": 215,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Chainable SQLAlchemy-like query stub returning fixed item lists for assistant message persistence paths.",
@@ -129543,8 +131812,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 198,
-          "end_line": 228,
+          "start_line": 218,
+          "end_line": 251,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Explicit in-memory DB session double limited to assistant message persistence paths.",
@@ -129568,8 +131837,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 231,
-          "end_line": 240,
+          "start_line": 254,
+          "end_line": 263,
           "tags": {},
           "relations": [
             {
@@ -129584,13 +131853,61 @@
             "score": 1.0
           }
         },
+        {
+          "name": "_dataset_review_session",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 266,
+          "end_line": 367,
+          "tags": {
+            "COMPLEXITY": "1",
+            "PURPOSE": "Build minimal owned dataset-review session fixture for assistant scoped routing tests."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "AssistantApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_await_none",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 370,
+          "end_line": 378,
+          "tags": {
+            "COMPLEXITY": "1",
+            "PURPOSE": "Async helper returning None for planner fallback tests."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "AssistantApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "test_unknown_command_returns_needs_clarification",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 243,
-          "end_line": 267,
+          "start_line": 381,
+          "end_line": 405,
           "tags": {
             "PURPOSE": "Unknown command should return clarification state and unknown intent."
           },
@@ -129612,8 +131929,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 270,
-          "end_line": 291,
+          "start_line": 408,
+          "end_line": 429,
           "tags": {
             "PURPOSE": "Capability query should return deterministic help response."
           },
@@ -129630,13 +131947,105 @@
             "score": 1.0
           }
         },
+        {
+          "name": "test_assistant_message_request_accepts_dataset_review_session_binding",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 432,
+          "end_line": 444,
+          "tags": {
+            "PURPOSE": "Assistant request schema should accept active dataset review session binding for scoped orchestration."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "AssistantApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "test_dataset_review_scoped_message_uses_masked_filter_context",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 447,
+          "end_line": 492,
+          "tags": {
+            "PURPOSE": "Session-scoped assistant context should mask imported-filter raw values before assistant-visible metadata is persisted."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "AssistantApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "test_dataset_review_scoped_command_returns_confirmation_for_mapping_approval",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 495,
+          "end_line": 525,
+          "tags": {
+            "PURPOSE": "Session-scoped assistant commands should route dataset-review mapping approvals into confirmation workflow with bound session metadata."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "AssistantApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "test_dataset_review_scoped_command_routes_field_semantics_update",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 528,
+          "end_line": 559,
+          "tags": {
+            "PURPOSE": "Session-scoped assistant commands should route semantic field updates through explicit confirmation metadata."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "AssistantApiTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "__init__",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 41,
-          "end_line": 41,
+          "start_line": 55,
+          "end_line": 55,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129654,8 +132063,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 70,
-          "end_line": 70,
+          "start_line": 84,
+          "end_line": 84,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129673,8 +132082,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 73,
-          "end_line": 73,
+          "start_line": 87,
+          "end_line": 87,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129692,8 +132101,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 85,
-          "end_line": 85,
+          "start_line": 99,
+          "end_line": 99,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129711,8 +132120,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 88,
-          "end_line": 88,
+          "start_line": 102,
+          "end_line": 102,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129730,25 +132139,6 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 93,
-          "end_line": 93,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "__init__",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
           "start_line": 107,
           "end_line": 107,
           "tags": {
@@ -129763,13 +132153,32 @@
             "score": 1.0
           }
         },
+        {
+          "name": "__init__",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 121,
+          "end_line": 121,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "get_environments",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 111,
-          "end_line": 111,
+          "start_line": 125,
+          "end_line": 125,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129787,8 +132196,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 114,
-          "end_line": 114,
+          "start_line": 128,
+          "end_line": 128,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129806,82 +132215,6 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 167,
-          "end_line": 167,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "filter",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 170,
-          "end_line": 170,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "order_by",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 174,
-          "end_line": 174,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "limit",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 177,
-          "end_line": 177,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "offset",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
           "start_line": 181,
           "end_line": 181,
           "tags": {
@@ -129896,13 +132229,127 @@
             "score": 1.0
           }
         },
+        {
+          "name": "outerjoin",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 184,
+          "end_line": 184,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "options",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 187,
+          "end_line": 187,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "filter",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 190,
+          "end_line": 190,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "order_by",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 194,
+          "end_line": 194,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "limit",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 197,
+          "end_line": 197,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "offset",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 201,
+          "end_line": 201,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "first",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 185,
-          "end_line": 185,
+          "start_line": 205,
+          "end_line": 205,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129920,8 +132367,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 188,
-          "end_line": 188,
+          "start_line": 208,
+          "end_line": 208,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129939,8 +132386,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 191,
-          "end_line": 191,
+          "start_line": 211,
+          "end_line": 211,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129958,8 +132405,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 204,
-          "end_line": 204,
+          "start_line": 224,
+          "end_line": 224,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129977,8 +132424,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 207,
-          "end_line": 207,
+          "start_line": 228,
+          "end_line": 228,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -129996,8 +132443,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 212,
-          "end_line": 212,
+          "start_line": 235,
+          "end_line": 235,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -130015,8 +132462,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 215,
-          "end_line": 215,
+          "start_line": 238,
+          "end_line": 238,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -130034,8 +132481,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 218,
-          "end_line": 218,
+          "start_line": 241,
+          "end_line": 241,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -130053,8 +132500,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 221,
-          "end_line": 221,
+          "start_line": 244,
+          "end_line": 244,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -130072,8 +132519,27 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 224,
-          "end_line": 224,
+          "start_line": 247,
+          "end_line": 247,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "_fake_dispatch_dataset_review_intent",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 460,
+          "end_line": 460,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -130094,9 +132560,14 @@
             "message": "Missing Mandatory Tag: @LAYER (required for complexity 3)",
             "severity": "WARNING",
             "line_number": 4
+          },
+          {
+            "message": "Fractal limit warning: Module length is 561 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 4
           }
         ],
-        "score": 0.7
+        "score": 0.5499999999999999
       }
     },
     {
@@ -131035,9 +133506,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 683,
+      "end_line": 983,
       "tags": {
-        "TIER": "STANDARD",
         "COMPLEXITY": "3",
         "SEMANTICS": "dataset_review, session, profile, findings, semantics, clarification, execution, sqlalchemy",
         "PURPOSE": "SQLAlchemy models for the dataset review orchestration flow.",
@@ -131060,8 +133530,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 23,
-          "end_line": 30,
+          "start_line": 34,
+          "end_line": 43,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131076,8 +133546,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 32,
-          "end_line": 43,
+          "start_line": 46,
+          "end_line": 59,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131092,8 +133562,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 45,
-          "end_line": 60,
+          "start_line": 62,
+          "end_line": 79,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131108,8 +133578,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 62,
-          "end_line": 75,
+          "start_line": 82,
+          "end_line": 97,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131124,8 +133594,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 77,
-          "end_line": 82,
+          "start_line": 100,
+          "end_line": 107,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131140,8 +133610,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 84,
-          "end_line": 96,
+          "start_line": 110,
+          "end_line": 126,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131156,8 +133626,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 98,
-          "end_line": 136,
+          "start_line": 129,
+          "end_line": 211,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131172,8 +133642,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 138,
-          "end_line": 145,
+          "start_line": 214,
+          "end_line": 223,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131188,8 +133658,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 147,
-          "end_line": 154,
+          "start_line": 226,
+          "end_line": 235,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131204,8 +133674,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 156,
-          "end_line": 179,
+          "start_line": 238,
+          "end_line": 270,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131220,8 +133690,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 181,
-          "end_line": 192,
+          "start_line": 273,
+          "end_line": 286,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131236,8 +133706,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 194,
-          "end_line": 199,
+          "start_line": 289,
+          "end_line": 296,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131252,8 +133722,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 201,
-          "end_line": 209,
+          "start_line": 299,
+          "end_line": 309,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131268,8 +133738,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 211,
-          "end_line": 229,
+          "start_line": 312,
+          "end_line": 336,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131284,8 +133754,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 231,
-          "end_line": 238,
+          "start_line": 339,
+          "end_line": 348,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131300,8 +133770,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 240,
-          "end_line": 246,
+          "start_line": 351,
+          "end_line": 359,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131316,8 +133786,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 248,
-          "end_line": 256,
+          "start_line": 362,
+          "end_line": 372,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131332,8 +133802,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 258,
-          "end_line": 274,
+          "start_line": 375,
+          "end_line": 399,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131348,8 +133818,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 276,
-          "end_line": 282,
+          "start_line": 402,
+          "end_line": 410,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131364,8 +133834,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 284,
-          "end_line": 292,
+          "start_line": 413,
+          "end_line": 423,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131380,8 +133850,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 294,
-          "end_line": 319,
+          "start_line": 426,
+          "end_line": 461,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131396,8 +133866,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 321,
-          "end_line": 327,
+          "start_line": 464,
+          "end_line": 472,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131412,8 +133882,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 329,
-          "end_line": 335,
+          "start_line": 475,
+          "end_line": 483,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131428,8 +133898,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 337,
-          "end_line": 354,
+          "start_line": 486,
+          "end_line": 509,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131444,8 +133914,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 356,
-          "end_line": 364,
+          "start_line": 512,
+          "end_line": 522,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131460,8 +133930,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 366,
-          "end_line": 373,
+          "start_line": 525,
+          "end_line": 534,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131476,8 +133946,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 375,
-          "end_line": 381,
+          "start_line": 537,
+          "end_line": 545,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131492,8 +133962,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 383,
-          "end_line": 402,
+          "start_line": 548,
+          "end_line": 574,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131508,8 +133978,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 404,
-          "end_line": 410,
+          "start_line": 577,
+          "end_line": 585,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131524,8 +133994,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 412,
-          "end_line": 419,
+          "start_line": 588,
+          "end_line": 597,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131540,8 +134010,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 421,
-          "end_line": 437,
+          "start_line": 600,
+          "end_line": 624,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131556,8 +134026,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 439,
-          "end_line": 445,
+          "start_line": 627,
+          "end_line": 635,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131572,8 +134042,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 447,
-          "end_line": 452,
+          "start_line": 638,
+          "end_line": 645,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131588,8 +134058,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 454,
-          "end_line": 460,
+          "start_line": 648,
+          "end_line": 656,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131604,8 +134074,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 462,
-          "end_line": 483,
+          "start_line": 659,
+          "end_line": 688,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131620,8 +134090,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 485,
-          "end_line": 492,
+          "start_line": 691,
+          "end_line": 700,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131636,8 +134106,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 494,
-          "end_line": 511,
+          "start_line": 703,
+          "end_line": 738,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131652,8 +134122,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 513,
-          "end_line": 520,
+          "start_line": 741,
+          "end_line": 750,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131668,8 +134138,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 522,
-          "end_line": 540,
+          "start_line": 753,
+          "end_line": 788,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131684,8 +134154,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 542,
-          "end_line": 554,
+          "start_line": 791,
+          "end_line": 807,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131700,8 +134170,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 556,
-          "end_line": 562,
+          "start_line": 810,
+          "end_line": 818,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131716,8 +134186,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 564,
-          "end_line": 578,
+          "start_line": 821,
+          "end_line": 842,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131732,8 +134202,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 580,
-          "end_line": 586,
+          "start_line": 845,
+          "end_line": 853,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131748,8 +134218,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 588,
-          "end_line": 604,
+          "start_line": 856,
+          "end_line": 878,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131764,8 +134234,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 606,
-          "end_line": 611,
+          "start_line": 881,
+          "end_line": 888,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131780,8 +134250,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 613,
-          "end_line": 633,
+          "start_line": 891,
+          "end_line": 915,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131796,8 +134266,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 635,
-          "end_line": 651,
+          "start_line": 918,
+          "end_line": 940,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131812,8 +134282,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 653,
-          "end_line": 658,
+          "start_line": 943,
+          "end_line": 950,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131828,8 +134298,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 660,
-          "end_line": 666,
+          "start_line": 953,
+          "end_line": 961,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131844,8 +134314,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 668,
-          "end_line": 681,
+          "start_line": 964,
+          "end_line": 981,
           "tags": {},
           "relations": [],
           "children": [],
@@ -131860,7 +134330,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 683 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 983 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -131874,9 +134344,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 105,
+      "end_line": 104,
       "tags": {
-        "TIER": "STANDARD",
         "COMPLEXITY": "3",
         "SEMANTICS": "database, mapping, environment, migration, sqlalchemy, sqlite",
         "PURPOSE": "Defines the database schema for environment metadata and database mappings using SQLAlchemy.",
@@ -131896,8 +134365,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 24,
-          "end_line": 31,
+          "start_line": 23,
+          "end_line": 30,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Enumeration of possible Superset resource types for ID mapping."
@@ -131915,8 +134384,8 @@
           "type": "Class",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 34,
-          "end_line": 43,
+          "start_line": 33,
+          "end_line": 42,
           "tags": {
             "COMPLEXITY": "1",
             "PURPOSE": "Enumeration of possible migration job statuses."
@@ -131934,8 +134403,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 45,
-          "end_line": 56,
+          "start_line": 44,
+          "end_line": 55,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Represents a Superset instance environment."
@@ -131958,8 +134427,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 58,
-          "end_line": 72,
+          "start_line": 57,
+          "end_line": 71,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Represents a mapping between source and target databases."
@@ -131972,12 +134441,12 @@
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 58
+                "line_number": 57
               },
               {
                 "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
                 "severity": "WARNING",
-                "line_number": 58
+                "line_number": 57
               }
             ],
             "score": 0.5499999999999999
@@ -131988,8 +134457,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 74,
-          "end_line": 86,
+          "start_line": 73,
+          "end_line": 85,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Represents a single migration execution job."
@@ -132007,8 +134476,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 88,
-          "end_line": 103,
+          "start_line": 87,
+          "end_line": 102,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Maps a universal UUID for a resource to its actual ID on a specific environment.",
@@ -134030,9 +136499,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 134,
+      "end_line": 132,
       "tags": {
-        "TIER": "STANDARD",
         "COMPLEXITY": "3",
         "SEMANTICS": "auth, models, user, role, permission, sqlalchemy",
         "PURPOSE": "SQLAlchemy models for multi-user authentication and authorization.",
@@ -134051,8 +136519,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 21,
-          "end_line": 29,
+          "start_line": 19,
+          "end_line": 27,
           "tags": {
             "PURPOSE": "Generates a unique UUID string.",
             "POST": "Returns a string representation of a new UUID."
@@ -134075,8 +136543,8 @@
           "type": "Table",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 31,
-          "end_line": 42,
+          "start_line": 29,
+          "end_line": 40,
           "tags": {
             "PURPOSE": "Association table for many-to-many relationship between Users and Roles."
           },
@@ -134106,8 +136574,8 @@
           "type": "Table",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 44,
-          "end_line": 55,
+          "start_line": 42,
+          "end_line": 53,
           "tags": {
             "PURPOSE": "Association table for many-to-many relationship between Roles and Permissions."
           },
@@ -134137,8 +136605,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 58,
-          "end_line": 78,
+          "start_line": 56,
+          "end_line": 76,
           "tags": {
             "PURPOSE": "Represents an identity that can authenticate to the system."
           },
@@ -134155,72 +136623,72 @@
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 58
+                "line_number": 56
               }
             ],
             "score": 0.0
@@ -134231,8 +136699,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 81,
-          "end_line": 98,
+          "start_line": 79,
+          "end_line": 96,
           "tags": {
             "PURPOSE": "Represents a collection of permissions."
           },
@@ -134253,82 +136721,82 @@
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 81
+                "line_number": 79
               }
             ],
             "score": 0.0
@@ -134339,8 +136807,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 101,
-          "end_line": 116,
+          "start_line": 99,
+          "end_line": 114,
           "tags": {
             "PURPOSE": "Represents a specific capability within the system."
           },
@@ -134357,72 +136825,72 @@
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Invalid @RELATION predicate: HAS_MANY. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 101
+                "line_number": 99
               }
             ],
             "score": 0.0
@@ -134433,8 +136901,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 119,
-          "end_line": 132,
+          "start_line": 117,
+          "end_line": 130,
           "tags": {
             "PURPOSE": "Maps an Active Directory group to a local System Role."
           },
@@ -134451,62 +136919,62 @@
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @INVARIANT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               },
               {
                 "message": "Missing @INVARIANT tag (required for complexity 5)",
                 "severity": "ERROR",
-                "line_number": 119
+                "line_number": 117
               }
             ],
             "score": 0.0
@@ -134531,9 +136999,8 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 62,
+      "end_line": 61,
       "tags": {
-        "TIER": "STANDARD",
         "COMPLEXITY": "3",
         "SEMANTICS": "profile, preferences, persistence, user, dashboard-filter, git, ui-preferences, sqlalchemy",
         "PURPOSE": "Defines persistent per-user profile settings for dashboard filter, Git identity/token, and UX preferences.",
@@ -134556,8 +137023,8 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 23,
-          "end_line": 60,
+          "start_line": 22,
+          "end_line": 59,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Stores Superset username binding and default \"my dashboards\" toggle for one authenticated user."
@@ -134612,7 +137079,7 @@
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 37,
+      "end_line": 39,
       "tags": {
         "COMPLEXITY": "1",
         "PURPOSE": "Unit tests for data models",
@@ -134621,7 +137088,7 @@
       "relations": [
         {
           "type": "VERIFIES",
-          "target": "src.models"
+          "target": "ModelsPackage"
         }
       ],
       "children": [
@@ -134631,7 +137098,7 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 17,
-          "end_line": 34,
+          "end_line": 36,
           "tags": {
             "PURPOSE": "Tests that Environment model correctly stores values.",
             "PRE": "Environment class is available.",
@@ -135195,217 +137662,29 @@
       }
     },
     {
-      "name": "test_release_candidate_valid",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 39,
-      "end_line": 47,
-      "tags": {
-        "PURPOSE": "Verify that a valid release candidate can be instantiated."
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_release_candidate_empty_id",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 49,
-      "end_line": 58,
-      "tags": {
-        "PURPOSE": "Verify that a release candidate with an empty ID is rejected.",
-        "TEST_FIXTURE": "valid_enterprise_policy"
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_enterprise_policy_valid",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 74,
-      "end_line": 82,
-      "tags": {
-        "PURPOSE": "Verify that a valid enterprise policy is accepted.",
-        "TEST_EDGE": "enterprise_policy_missing_prohibited"
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_enterprise_policy_missing_prohibited",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 84,
-      "end_line": 93,
-      "tags": {
-        "PURPOSE": "Verify that an enterprise policy without prohibited categories is rejected.",
-        "TEST_EDGE": "enterprise_policy_external_allowed"
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_enterprise_policy_external_allowed",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 95,
-      "end_line": 105,
-      "tags": {
-        "PURPOSE": "Verify that an enterprise policy allowing external sources is rejected.",
-        "TEST_INVARIANT": "manifest_consistency",
-        "TEST_EDGE": "manifest_count_mismatch"
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_manifest_count_mismatch",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 107,
-      "end_line": 132,
-      "tags": {
-        "PURPOSE": "Verify that a manifest with count mismatches is rejected.",
-        "TEST_INVARIANT": "run_integrity",
-        "TEST_EDGE": "compliant_run_stage_fail"
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_compliant_run_validation",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 134,
-      "end_line": 166,
-      "tags": {
-        "PURPOSE": "Verify compliant run validation logic and mandatory stage checks."
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_report_validation",
-      "type": "Function",
-      "complexity": 1,
-      "tier": "TRIVIAL",
-      "start_line": 168,
-      "end_line": 188,
-      "tags": {
-        "PURPOSE": "Verify compliance report validation based on status and violation counts."
-      },
-      "relations": [
-        {
-          "type": "BINDS_TO",
-          "target": "__tests__/test_clean_release"
-        }
-      ],
-      "children": [],
-      "compliance": {
-        "valid": true,
-        "issues": [],
-        "score": 1.0
-      }
-    },
-    {
-      "name": "test_clean_release",
+      "name": "TestCleanReleaseModels",
       "type": "Module",
       "complexity": 1,
       "tier": "TRIVIAL",
       "start_line": 1,
-      "end_line": 188,
+      "end_line": 4,
       "tags": {
-        "PURPOSE": "Auto-generated module for backend/src/models/__tests__/test_clean_release.py",
-        "COMPLEXITY": "1",
-        "LAYER": "Unknown"
+        "PURPOSE": "Contract testing for Clean Release models"
       },
-      "relations": [],
+      "relations": [
+        {
+          "type": "VERIFIES",
+          "target": "CleanReleaseModels"
+        }
+      ],
       "children": [
         {
           "name": "valid_candidate_data",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 29,
-          "end_line": 29,
+          "start_line": 30,
+          "end_line": 30,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -135423,8 +137702,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 61,
-          "end_line": 61,
+          "start_line": 67,
+          "end_line": 67,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -135438,6 +137717,203 @@
           }
         }
       ],
+      "compliance": {
+        "valid": true,
+        "issues": [
+          {
+            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
+            "severity": "WARNING",
+            "line_number": 1
+          }
+        ],
+        "score": 0.85
+      }
+    },
+    {
+      "name": "test_release_candidate_valid",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 41,
+      "end_line": 50,
+      "tags": {
+        "PURPOSE": "Verify that a valid release candidate can be instantiated."
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      }
+    },
+    {
+      "name": "test_release_candidate_empty_id",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 53,
+      "end_line": 63,
+      "tags": {
+        "PURPOSE": "Verify that a release candidate with an empty ID is rejected.",
+        "TEST_FIXTURE": "valid_enterprise_policy"
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      }
+    },
+    {
+      "name": "test_enterprise_policy_valid",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 81,
+      "end_line": 90,
+      "tags": {
+        "PURPOSE": "Verify that a valid enterprise policy is accepted.",
+        "TEST_EDGE": "enterprise_policy_missing_prohibited"
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      }
+    },
+    {
+      "name": "test_enterprise_policy_missing_prohibited",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 93,
+      "end_line": 106,
+      "tags": {
+        "PURPOSE": "Verify that an enterprise policy without prohibited categories is rejected.",
+        "TEST_EDGE": "enterprise_policy_external_allowed"
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      }
+    },
+    {
+      "name": "test_enterprise_policy_external_allowed",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 109,
+      "end_line": 123,
+      "tags": {
+        "PURPOSE": "Verify that an enterprise policy allowing external sources is rejected.",
+        "TEST_INVARIANT": "manifest_consistency",
+        "TEST_EDGE": "manifest_count_mismatch"
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      }
+    },
+    {
+      "name": "test_manifest_count_mismatch",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 126,
+      "end_line": 168,
+      "tags": {
+        "PURPOSE": "Verify that a manifest with count mismatches is rejected.",
+        "TEST_INVARIANT": "run_integrity",
+        "TEST_EDGE": "compliant_run_stage_fail"
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      }
+    },
+    {
+      "name": "test_compliant_run_validation",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 171,
+      "end_line": 214,
+      "tags": {
+        "PURPOSE": "Verify compliant run validation logic and mandatory stage checks."
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
+      "compliance": {
+        "valid": true,
+        "issues": [],
+        "score": 1.0
+      }
+    },
+    {
+      "name": "test_report_validation",
+      "type": "Function",
+      "complexity": 1,
+      "tier": "TRIVIAL",
+      "start_line": 217,
+      "end_line": 249,
+      "tags": {
+        "PURPOSE": "Verify compliance report validation based on status and violation counts."
+      },
+      "relations": [
+        {
+          "type": "BINDS_TO",
+          "target": "TestCleanReleaseModels"
+        }
+      ],
+      "children": [],
       "compliance": {
         "valid": true,
         "issues": [],
@@ -137097,7 +139573,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 364,
+      "end_line": 384,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "health, aggregation, dashboards",
@@ -137107,15 +139583,19 @@
       "relations": [
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.models.llm.ValidationRecord"
+          "target": "ValidationRecord"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.core.superset_client.SupersetClient"
+          "target": "SupersetClient"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.core.task_manager.cleanup.TaskCleanupService"
+          "target": "TaskCleanupService"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "TaskManager"
         }
       ],
       "children": [
@@ -137124,8 +139604,8 @@
           "type": "Class",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 23,
-          "end_line": 362,
+          "start_line": 28,
+          "end_line": 382,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Aggregate latest dashboard validation state and manage persisted health report lifecycle.",
@@ -137137,27 +139617,27 @@
           "relations": [
             {
               "type": "DEPENDS_ON",
-              "target": "sqlalchemy.orm.Session"
+              "target": "ValidationRecord"
             },
             {
               "type": "DEPENDS_ON",
-              "target": "backend.src.models.llm.ValidationRecord"
+              "target": "DashboardHealthItem"
             },
             {
               "type": "DEPENDS_ON",
-              "target": "backend.src.schemas.health.DashboardHealthItem"
+              "target": "HealthSummaryResponse"
             },
             {
               "type": "DEPENDS_ON",
-              "target": "backend.src.schemas.health.HealthSummaryResponse"
+              "target": "SupersetClient"
             },
             {
-              "type": "CALLS",
-              "target": "backend.src.core.superset_client.SupersetClient"
+              "type": "DEPENDS_ON",
+              "target": "TaskCleanupService"
             },
             {
-              "type": "CALLS",
-              "target": "backend.src.core.task_manager.cleanup.TaskCleanupService"
+              "type": "DEPENDS_ON",
+              "target": "TaskManager"
             }
           ],
           "children": [
@@ -137166,8 +139646,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 46,
-              "end_line": 60,
+              "start_line": 51,
+              "end_line": 64,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Initialize health service with DB session and optional config access for dashboard metadata resolution.",
@@ -137179,11 +139659,7 @@
               "relations": [
                 {
                   "type": "BINDS_TO",
-                  "target": "backend.src.services.health_service.HealthService"
-                },
-                {
-                  "type": "DEPENDS_ON",
-                  "target": "sqlalchemy.orm.Session"
+                  "target": "HealthService"
                 }
               ],
               "children": [],
@@ -137198,8 +139674,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 62,
-              "end_line": 151,
+              "start_line": 66,
+              "end_line": 156,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Warm dashboard slug/title cache with one Superset list fetch per environment.",
@@ -137211,19 +139687,15 @@
               "relations": [
                 {
                   "type": "DEPENDS_ON",
-                  "target": "backend.src.models.llm.ValidationRecord"
+                  "target": "ValidationRecord"
                 },
                 {
                   "type": "DEPENDS_ON",
-                  "target": "backend.src.core.superset_client.SupersetClient"
+                  "target": "ConfigManager"
                 },
                 {
-                  "type": "CALLS",
-                  "target": "config_manager.get_environments"
-                },
-                {
-                  "type": "CALLS",
-                  "target": "backend.src.core.superset_client.SupersetClient.get_dashboards_summary"
+                  "type": "DEPENDS_ON",
+                  "target": "SupersetClient"
                 }
               ],
               "children": [],
@@ -137238,8 +139710,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 153,
-              "end_line": 182,
+              "start_line": 158,
+              "end_line": 187,
               "tags": {
                 "COMPLEXITY": "1",
                 "PURPOSE": "Resolve slug/title for a dashboard referenced by persisted validation record.",
@@ -137260,8 +139732,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 184,
-              "end_line": 269,
+              "start_line": 189,
+              "end_line": 291,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Aggregate latest validation status per dashboard and enrich rows with dashboard slug/title.",
@@ -137273,11 +139745,11 @@
               "relations": [
                 {
                   "type": "CALLS",
-                  "target": "self._prime_dashboard_meta_cache"
+                  "target": "_prime_dashboard_meta_cache"
                 },
                 {
                   "type": "CALLS",
-                  "target": "self._resolve_dashboard_meta"
+                  "target": "_resolve_dashboard_meta"
                 }
               ],
               "children": [],
@@ -137292,8 +139764,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 271,
-              "end_line": 359,
+              "start_line": 293,
+              "end_line": 379,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Delete one persisted health report and optionally clean linked task/log artifacts.",
@@ -137305,23 +139777,15 @@
               "relations": [
                 {
                   "type": "DEPENDS_ON",
-                  "target": "backend.src.models.llm.ValidationRecord"
+                  "target": "ValidationRecord"
                 },
                 {
                   "type": "DEPENDS_ON",
-                  "target": "backend.src.core.task_manager.TaskManager"
+                  "target": "TaskManager"
                 },
                 {
-                  "type": "CALLS",
-                  "target": "os.path.exists"
-                },
-                {
-                  "type": "CALLS",
-                  "target": "os.remove"
-                },
-                {
-                  "type": "CALLS",
-                  "target": "backend.src.core.task_manager.cleanup.TaskCleanupService.delete_task_with_logs"
+                  "type": "DEPENDS_ON",
+                  "target": "TaskCleanupService"
                 }
               ],
               "children": [],
@@ -137338,13 +139802,32 @@
             "score": 0.9400000000000001
           }
         },
+        {
+          "name": "_empty_dashboard_meta",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 24,
+          "end_line": 24,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "__init__",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 55,
-          "end_line": 55,
+          "start_line": 59,
+          "end_line": 59,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -137362,7 +139845,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 364 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 384 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -137376,7 +139859,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 216,
+      "end_line": 270,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "service, llm, provider, encryption",
@@ -137386,11 +139869,15 @@
       "relations": [
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.core.database:Function"
+          "target": "LLMProvider"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.models.llm:Function"
+          "target": "EncryptionManager"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "LLMProviderConfig"
         }
       ],
       "children": [
@@ -137399,14 +139886,15 @@
           "type": "Function",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 20,
-          "end_line": 44,
+          "start_line": 22,
+          "end_line": 53,
           "tags": {
             "COMPLEXITY": "5",
             "PURPOSE": "Load and validate the Fernet key used for secret encryption.",
             "PRE": "ENCRYPTION_KEY environment variable must be set to a valid Fernet key.",
             "POST": "Returns validated key bytes ready for Fernet initialization.",
             "SIDE_EFFECT": "Emits belief-state logs for missing or invalid encryption configuration.",
+            "DATA_CONTRACT": "Input[ENCRYPTION_KEY:str] -> Output[bytes]",
             "INVARIANT": "Encryption initialization never falls back to a hardcoded secret."
           },
           "relations": [
@@ -137417,20 +139905,9 @@
           ],
           "children": [],
           "compliance": {
-            "valid": false,
-            "issues": [
-              {
-                "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 20
-              },
-              {
-                "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 20
-              }
-            ],
-            "score": 0.0
+            "valid": true,
+            "issues": [],
+            "score": 0.95
           }
         },
         {
@@ -137438,26 +139915,35 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 46,
-          "end_line": 89,
+          "start_line": 56,
+          "end_line": 109,
           "tags": {
             "COMPLEXITY": "5",
             "PURPOSE": "Handles encryption and decryption of sensitive data like API keys.",
+            "PRE": "ENCRYPTION_KEY is configured with a valid Fernet key before instantiation.",
+            "POST": "Manager exposes reversible encrypt/decrypt operations for persisted secrets.",
+            "SIDE_EFFECT": "Initializes Fernet cryptography state from process environment.",
+            "DATA_CONTRACT": "Input[str] -> Output[str]",
             "INVARIANT": "Uses only a validated secret key from environment.",
             "TEST_CONTRACT": "EncryptionManagerModel ->",
             "TEST_FIXTURE": "basic_encryption_cycle -> {\"data\": \"my_secret_key\"}",
             "TEST_EDGE": "empty_string_encryption -> {\"data\": \"\"}",
             "TEST_INVARIANT": "symmetric_encryption -> verifies: [basic_encryption_cycle, empty_string_encryption]"
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "CALLS",
+              "target": "_require_fernet_key"
+            }
+          ],
           "children": [
             {
               "name": "EncryptionManager_init",
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 63,
-              "end_line": 70,
+              "start_line": 78,
+              "end_line": 86,
               "tags": {
                 "PURPOSE": "Initialize the encryption manager with a Fernet key.",
                 "PRE": "ENCRYPTION_KEY env var must be set to a valid Fernet key.",
@@ -137476,8 +139962,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 72,
-              "end_line": 79,
+              "start_line": 88,
+              "end_line": 96,
               "tags": {
                 "PURPOSE": "Encrypt a plaintext string.",
                 "PRE": "data must be a non-empty string.",
@@ -137496,8 +139982,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 81,
-              "end_line": 88,
+              "start_line": 98,
+              "end_line": 106,
               "tags": {
                 "PURPOSE": "Decrypt an encrypted string.",
                 "PRE": "encrypted_data must be a valid Fernet-encrypted string.",
@@ -137513,60 +139999,9 @@
             }
           ],
           "compliance": {
-            "valid": false,
-            "issues": [
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @PRE (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @POST (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              },
-              {
-                "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 46
-              }
-            ],
-            "score": 0.0
+            "valid": true,
+            "issues": [],
+            "score": 0.9571428571428571
           }
         },
         {
@@ -137574,27 +140009,45 @@
           "type": "Class",
           "complexity": 3,
           "tier": "STANDARD",
-          "start_line": 91,
-          "end_line": 214,
+          "start_line": 112,
+          "end_line": 268,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Service to manage LLM provider lifecycle."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMProvider"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "EncryptionManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "LLMProviderConfig"
+            }
+          ],
           "children": [
             {
               "name": "LLMProviderService_init",
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 95,
-              "end_line": 102,
+              "start_line": 119,
+              "end_line": 128,
               "tags": {
                 "PURPOSE": "Initialize the service with database session.",
                 "PRE": "db must be a valid SQLAlchemy Session.",
                 "POST": "Service ready for provider operations."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "EncryptionManager"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
@@ -137607,36 +140060,25 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 104,
-              "end_line": 112,
+              "start_line": 130,
+              "end_line": 140,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Returns all configured LLM providers.",
                 "PRE": "Database connection must be active.",
                 "POST": "Returns list of all LLMProvider records."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProvider"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 104
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 104
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 104
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             },
             {
@@ -137644,36 +140086,25 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 114,
-              "end_line": 122,
+              "start_line": 142,
+              "end_line": 154,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Returns a single LLM provider by ID.",
                 "PRE": "provider_id must be a valid string.",
                 "POST": "Returns LLMProvider or None if not found."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProvider"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 114
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 114
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 114
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             },
             {
@@ -137681,36 +140112,33 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 124,
-              "end_line": 144,
+              "start_line": 156,
+              "end_line": 180,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Creates a new LLM provider with encrypted API key.",
                 "PRE": "config must contain valid provider configuration.",
                 "POST": "New provider created and persisted to database."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProviderConfig"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProvider"
+                },
+                {
+                  "type": "CALLS",
+                  "target": "encrypt"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 124
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 124
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 124
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             },
             {
@@ -137718,36 +140146,33 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 146,
-              "end_line": 173,
+              "start_line": 182,
+              "end_line": 215,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Updates an existing LLM provider.",
                 "PRE": "provider_id must exist, config must be valid.",
                 "POST": "Provider updated and persisted to database."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProviderConfig"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProvider"
+                },
+                {
+                  "type": "CALLS",
+                  "target": "encrypt"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 146
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 146
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 146
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             },
             {
@@ -137755,36 +140180,25 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 175,
-              "end_line": 188,
+              "start_line": 217,
+              "end_line": 232,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Deletes an LLM provider.",
                 "PRE": "provider_id must exist.",
                 "POST": "Provider removed from database."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProvider"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 175
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 175
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 175
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             },
             {
@@ -137792,54 +140206,36 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 190,
-              "end_line": 212,
+              "start_line": 234,
+              "end_line": 265,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Returns the decrypted API key for a provider.",
                 "PRE": "provider_id must exist with valid encrypted key.",
                 "POST": "Returns decrypted API key or None on failure."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "LLMProvider"
+                },
+                {
+                  "type": "CALLS",
+                  "target": "decrypt"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 190
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 190
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 190
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             }
           ],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                "severity": "WARNING",
-                "line_number": 91
-              },
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                "severity": "WARNING",
-                "line_number": 91
-              }
-            ],
-            "score": 0.5499999999999999
+            "issues": [],
+            "score": 0.85
           }
         },
         {
@@ -137847,8 +140243,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 67,
-          "end_line": 67,
+          "start_line": 82,
+          "end_line": 82,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -137866,8 +140262,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 99,
-          "end_line": 99,
+          "start_line": 124,
+          "end_line": 124,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -138160,7 +140556,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 137,
+      "end_line": 149,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "auth, service, business-logic, login, jwt, adfs, jit-provisioning",
@@ -138201,20 +140597,33 @@
           "complexity": 3,
           "tier": "STANDARD",
           "start_line": 29,
-          "end_line": 135,
+          "end_line": 147,
           "tags": {
             "COMPLEXITY": "3",
             "PURPOSE": "Provides high-level authentication services."
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "AuthRepository"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "User"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "Role"
+            }
+          ],
           "children": [
             {
               "name": "AuthService_init",
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 33,
-              "end_line": 45,
+              "start_line": 36,
+              "end_line": 48,
               "tags": {
                 "COMPLEXITY": "1",
                 "PURPOSE": "Initializes the authentication service with repository access over an active DB session.",
@@ -138237,8 +140646,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 47,
-              "end_line": 73,
+              "start_line": 50,
+              "end_line": 79,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Validates credentials and account state for local username/password authentication.",
@@ -138249,28 +140658,25 @@
                 "PARAM": "password (str) - The plain password.",
                 "RETURN": "Optional[User] - The authenticated user or None."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "AuthRepository"
+                },
+                {
+                  "type": "CALLS",
+                  "target": "verify_password"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "User"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 47
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 47
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 47
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             },
             {
@@ -138278,8 +140684,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 75,
-              "end_line": 92,
+              "start_line": 81,
+              "end_line": 101,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Issues an access token payload for an already authenticated user.",
@@ -138290,28 +140696,25 @@
                 "PARAM": "user (User) - The authenticated user.",
                 "RETURN": "Dict[str, str] - Session data."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "create_access_token"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "User"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "Role"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 75
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 75
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 75
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             },
             {
@@ -138319,8 +140722,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 94,
-              "end_line": 132,
+              "start_line": 103,
+              "end_line": 144,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Performs ADFS Just-In-Time provisioning and role synchronization from AD group mappings.",
@@ -138331,46 +140734,32 @@
                 "PARAM": "user_info (Dict[str, Any]) - Claims from ADFS token.",
                 "RETURN": "User - The provisioned user."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "AuthRepository"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "User"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "Role"
+                }
+              ],
               "children": [],
               "compliance": {
                 "valid": true,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 94
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 94
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                    "severity": "WARNING",
-                    "line_number": 94
-                  }
-                ],
-                "score": 0.4
+                "issues": [],
+                "score": 0.85
               }
             }
           ],
           "compliance": {
             "valid": true,
-            "issues": [
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                "severity": "WARNING",
-                "line_number": 29
-              },
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 3)",
-                "severity": "WARNING",
-                "line_number": 29
-              }
-            ],
-            "score": 0.5499999999999999
+            "issues": [],
+            "score": 0.85
           }
         },
         {
@@ -138378,8 +140767,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 41,
-          "end_line": 41,
+          "start_line": 44,
+          "end_line": 44,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -138397,8 +140786,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 57,
-          "end_line": 57,
+          "start_line": 63,
+          "end_line": 63,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -138416,8 +140805,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 84,
-          "end_line": 84,
+          "start_line": 93,
+          "end_line": 93,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -138435,8 +140824,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 103,
-          "end_line": 103,
+          "start_line": 115,
+          "end_line": 115,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -142832,7 +145221,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 146,
+      "end_line": 238,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "notifications, service, routing, dispatch, background-tasks",
@@ -142843,34 +145232,285 @@
       "relations": [
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.services.notifications.providers"
+          "target": "NotificationProvider"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.services.profile_service"
+          "target": "SMTPProvider"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.models.llm"
+          "target": "TelegramProvider"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "SlackProvider"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "ValidationRecord"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "ValidationPolicy"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "UserDashboardPreference"
         }
       ],
       "children": [
         {
           "name": "NotificationService",
           "type": "Class",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 25,
-          "end_line": 144,
+          "complexity": 4,
+          "tier": "STANDARD",
+          "start_line": 34,
+          "end_line": 236,
           "tags": {
-            "PURPOSE": "Routes validation reports to appropriate users and channels."
+            "PURPOSE": "Routes validation reports to appropriate users and channels.",
+            "COMPLEXITY": "4",
+            "PRE": "Service receives a live DB session and configuration manager with notification payload settings.",
+            "POST": "Service can resolve targets and dispatch provider sends without mutating validation records.",
+            "SIDE_EFFECT": "Reads notification configuration, queries user preferences, and dispatches provider I/O.",
+            "DATA_CONTRACT": "Input[ValidationRecord, Optional[ValidationPolicy], Optional[BackgroundTasks]] -> Output[None]"
           },
-          "relations": [],
-          "children": [],
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "NotificationProvider"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ValidationRecord"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "ValidationPolicy"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "UserDashboardPreference"
+            }
+          ],
+          "children": [
+            {
+              "name": "NotificationService_init",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 46,
+              "end_line": 57,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Bind DB and configuration collaborators used for provider initialization and routing."
+              },
+              "relations": [
+                {
+                  "type": "BINDS_TO",
+                  "target": "NotificationService"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "ValidationPolicy"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_initialize_providers",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 59,
+              "end_line": 83,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Materialize configured notification channel adapters once per service lifetime."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "SMTPProvider"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TelegramProvider"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "SlackProvider"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "dispatch_report",
+              "type": "Function",
+              "complexity": 4,
+              "tier": "STANDARD",
+              "start_line": 85,
+              "end_line": 141,
+              "tags": {
+                "COMPLEXITY": "4",
+                "PURPOSE": "Route one validation record to resolved owners and configured custom channels.",
+                "PRE": "record is persisted and providers can be initialized from configuration payload.",
+                "POST": "Eligible notification sends are scheduled in background or awaited inline.",
+                "SIDE_EFFECT": "Schedules or performs outbound provider sends and emits notification logs.",
+                "DATA_CONTRACT": "Input[ValidationRecord, Optional[ValidationPolicy], Optional[BackgroundTasks]] -> Output[None]"
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "_initialize_providers"
+                },
+                {
+                  "type": "CALLS",
+                  "target": "_should_notify"
+                },
+                {
+                  "type": "CALLS",
+                  "target": "_resolve_targets"
+                },
+                {
+                  "type": "CALLS",
+                  "target": "_build_body"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.9400000000000001
+              }
+            },
+            {
+              "name": "_should_notify",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 143,
+              "end_line": 159,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Evaluate record status against effective alert policy."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "ValidationRecord"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "ValidationPolicy"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_resolve_targets",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 161,
+              "end_line": 196,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Resolve owner and policy-defined delivery targets for one validation record."
+              },
+              "relations": [
+                {
+                  "type": "CALLS",
+                  "target": "_find_dashboard_owners"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "ValidationRecord"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "ValidationPolicy"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_find_dashboard_owners",
+              "type": "Function",
+              "complexity": 3,
+              "tier": "STANDARD",
+              "start_line": 198,
+              "end_line": 218,
+              "tags": {
+                "COMPLEXITY": "3",
+                "PURPOSE": "Load candidate dashboard owners from persisted profile preferences."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "ValidationRecord"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "UserDashboardPreference"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.85
+              }
+            },
+            {
+              "name": "_build_body",
+              "type": "Function",
+              "complexity": 2,
+              "tier": "TRIVIAL",
+              "start_line": 220,
+              "end_line": 233,
+              "tags": {
+                "COMPLEXITY": "2",
+                "PURPOSE": "Format one validation record into provider-ready body text."
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "ValidationRecord"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 1.0
+              }
+            }
+          ],
           "compliance": {
             "valid": true,
             "issues": [],
-            "score": 1.0
+            "score": 0.9400000000000001
           }
         },
         {
@@ -142878,122 +145518,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 28,
-          "end_line": 28,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "_initialize_providers",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 34,
-          "end_line": 34,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "dispatch_report",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 52,
-          "end_line": 52,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "_should_notify",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 91,
-          "end_line": 91,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "_resolve_targets",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 100,
-          "end_line": 100,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "_find_dashboard_owners",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 125,
-          "end_line": 125,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
-        },
-        {
-          "name": "_build_body",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 136,
-          "end_line": 136,
+          "start_line": 51,
+          "end_line": 51,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -149028,7 +151554,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 246,
+      "end_line": 306,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "reports, service, aggregation, filtering, pagination, detail",
@@ -149039,15 +151565,31 @@
       "relations": [
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.core.task_manager.manager.TaskManager:Function"
+          "target": "TaskManager"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.models.report:Function"
+          "target": "TaskReport"
         },
         {
           "type": "DEPENDS_ON",
-          "target": "backend.src.services.reports.normalizer:Function"
+          "target": "ReportQuery"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "ReportCollection"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "ReportDetailView"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "normalize_task_report"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "CleanReleaseRepository"
         }
       ],
       "children": [
@@ -149056,88 +151598,72 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 24,
-          "end_line": 244,
+          "start_line": 35,
+          "end_line": 304,
           "tags": {
             "PURPOSE": "Service layer for list/detail report retrieval and normalization.",
             "COMPLEXITY": "5",
             "PRE": "TaskManager dependency is initialized.",
             "POST": "Provides deterministic list/detail report responses.",
+            "SIDE_EFFECT": "Reads task history and optional clean-release repository state without mutating source records.",
+            "DATA_CONTRACT": "Input[TaskManager, Optional[CleanReleaseRepository], ReportQuery|report_id] -> Output[ReportCollection|ReportDetailView|None]",
             "INVARIANT": "Service methods are read-only over task history source.",
             "TEST_CONTRACT": "ReportsServiceModel ->",
             "TEST_FIXTURE": "valid_service -> {\"task_manager\": \"MockTaskManager()\"}",
             "TEST_EDGE": "report_not_found -> get_report_detail returns None",
             "TEST_INVARIANT": "consistent_pagination -> verifies: [valid_service]"
           },
-          "relations": [],
+          "relations": [
+            {
+              "type": "DEPENDS_ON",
+              "target": "TaskManager"
+            },
+            {
+              "type": "DEPENDS_ON",
+              "target": "CleanReleaseRepository"
+            },
+            {
+              "type": "CALLS",
+              "target": "normalize_task_report"
+            }
+          ],
           "children": [
             {
               "name": "init",
               "type": "Function",
               "complexity": 5,
               "tier": "CRITICAL",
-              "start_line": 44,
-              "end_line": 55,
+              "start_line": 60,
+              "end_line": 81,
               "tags": {
                 "COMPLEXITY": "5",
                 "PURPOSE": "Initialize service with TaskManager dependency.",
                 "PRE": "task_manager is a live TaskManager instance.",
                 "POST": "self.task_manager is assigned and ready for read operations.",
                 "INVARIANT": "Constructor performs no task mutations.",
+                "SIDE_EFFECT": "Stores collaborator references for later read-only report projections.",
+                "DATA_CONTRACT": "Input[TaskManager, Optional[CleanReleaseRepository]] -> Output[ReportsService]",
                 "PARAM": "task_manager (TaskManager) - Task manager providing source task history."
               },
-              "relations": [],
+              "relations": [
+                {
+                  "type": "BINDS_TO",
+                  "target": "ReportsService"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "TaskManager"
+                },
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "CleanReleaseRepository"
+                }
+              ],
               "children": [],
               "compliance": {
-                "valid": false,
-                "issues": [
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  },
-                  {
-                    "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                    "severity": "ERROR",
-                    "line_number": 44
-                  }
-                ],
-                "score": 0.0
+                "valid": true,
+                "issues": [],
+                "score": 0.95
               }
             },
             {
@@ -149145,8 +151671,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 57,
-              "end_line": 68,
+              "start_line": 83,
+              "end_line": 95,
               "tags": {
                 "PURPOSE": "Build normalized reports from all available tasks.",
                 "PRE": "Task manager returns iterable task history records.",
@@ -149167,8 +151693,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 70,
-              "end_line": 84,
+              "start_line": 97,
+              "end_line": 112,
               "tags": {
                 "PURPOSE": "Normalize naive/aware datetime values to UTC-aware datetime for safe comparisons.",
                 "PRE": "value is either datetime or None.",
@@ -149190,8 +151716,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 86,
-              "end_line": 99,
+              "start_line": 114,
+              "end_line": 128,
               "tags": {
                 "PURPOSE": "Produce stable numeric sort key for report timestamps.",
                 "PRE": "report contains updated_at datetime.",
@@ -149213,8 +151739,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 101,
-              "end_line": 129,
+              "start_line": 130,
+              "end_line": 167,
               "tags": {
                 "PURPOSE": "Apply query filtering to a report.",
                 "PRE": "report and query are normalized schema instances.",
@@ -149236,8 +151762,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 131,
-              "end_line": 151,
+              "start_line": 169,
+              "end_line": 192,
               "tags": {
                 "PURPOSE": "Sort reports deterministically according to query settings.",
                 "PRE": "reports contains only TaskReport items.",
@@ -149259,8 +151785,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 153,
-              "end_line": 179,
+              "start_line": 194,
+              "end_line": 223,
               "tags": {
                 "PURPOSE": "Return filtered, sorted, paginated report collection.",
                 "PRE": "query has passed schema validation.",
@@ -149281,8 +151807,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 181,
-              "end_line": 243,
+              "start_line": 225,
+              "end_line": 301,
               "tags": {
                 "PURPOSE": "Return one normalized report with timeline/diagnostics/next actions.",
                 "PRE": "report_id exists in normalized report set.",
@@ -149300,40 +151826,9 @@
             }
           ],
           "compliance": {
-            "valid": false,
-            "issues": [
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 24
-              },
-              {
-                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 24
-              },
-              {
-                "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 24
-              },
-              {
-                "message": "Missing Mandatory Tag: @RELATION (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 24
-              },
-              {
-                "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 24
-              },
-              {
-                "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
-                "severity": "ERROR",
-                "line_number": 24
-              }
-            ],
-            "score": 0.0
+            "valid": true,
+            "issues": [],
+            "score": 0.9571428571428571
           }
         },
         {
@@ -149341,8 +151836,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 51,
-          "end_line": 51,
+          "start_line": 72,
+          "end_line": 72,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -149378,6 +151873,11 @@
             "message": "Missing Mandatory Tag: @DATA_CONTRACT (required for complexity 5)",
             "severity": "ERROR",
             "line_number": 1
+          },
+          {
+            "message": "Fractal limit warning: Module length is 306 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 1
           }
         ],
         "score": 0.0
@@ -150526,7 +153026,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 1180,
+      "end_line": 1196,
       "tags": {
         "COMPLEXITY": "5",
         "SEMANTICS": "dataset_review, orchestration, session_lifecycle, intake, recovery",
@@ -150625,7 +153125,7 @@
           "complexity": 2,
           "tier": "TRIVIAL",
           "start_line": 105,
-          "end_line": 114,
+          "end_line": 115,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Typed input contract for compiling one Superset-backed session preview."
@@ -150643,8 +153143,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 117,
-          "end_line": 127,
+          "start_line": 118,
+          "end_line": 128,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Result contract for one persisted compiled preview attempt."
@@ -150662,8 +153162,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 130,
-          "end_line": 139,
+          "start_line": 131,
+          "end_line": 141,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Typed input contract for launching one dataset-review session into SQL Lab."
@@ -150681,8 +153181,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 142,
-          "end_line": 152,
+          "start_line": 144,
+          "end_line": 154,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Launch result carrying immutable run context and any gate blockers surfaced before launch."
@@ -150700,8 +153200,8 @@
           "type": "Class",
           "complexity": 5,
           "tier": "CRITICAL",
-          "start_line": 155,
-          "end_line": 1178,
+          "start_line": 157,
+          "end_line": 1194,
           "tags": {
             "COMPLEXITY": "5",
             "PURPOSE": "Coordinate safe session startup while preserving cross-user isolation and explicit partial recovery.",
@@ -150739,8 +153239,8 @@
               "type": "Function",
               "complexity": 3,
               "tier": "STANDARD",
-              "start_line": 169,
-              "end_line": 191,
+              "start_line": 171,
+              "end_line": 193,
               "tags": {
                 "COMPLEXITY": "3",
                 "PURPOSE": "Bind repository, config, and task dependencies required by the orchestration boundary.",
@@ -150778,8 +153278,8 @@
               "type": "Function",
               "complexity": 5,
               "tier": "CRITICAL",
-              "start_line": 193,
-              "end_line": 386,
+              "start_line": 195,
+              "end_line": 389,
               "tags": {
                 "COMPLEXITY": "5",
                 "PURPOSE": "Initialize a new session from a Superset link or dataset selection and trigger context recovery.",
@@ -150815,8 +153315,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 388,
-              "end_line": 498,
+              "start_line": 391,
+              "end_line": 506,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Assemble effective execution inputs and trigger Superset-side preview compilation.",
@@ -150843,8 +153343,8 @@
               "type": "Function",
               "complexity": 5,
               "tier": "CRITICAL",
-              "start_line": 500,
-              "end_line": 632,
+              "start_line": 508,
+              "end_line": 645,
               "tags": {
                 "COMPLEXITY": "5",
                 "PURPOSE": "Start the approved dataset execution through SQL Lab and persist run context for audit/replay.",
@@ -150872,8 +153372,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 634,
-              "end_line": 655,
+              "start_line": 647,
+              "end_line": 668,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Normalize dataset-selection payload into canonical session references."
@@ -150896,8 +153396,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 657,
-              "end_line": 698,
+              "start_line": 670,
+              "end_line": 711,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Create the first profile snapshot so exports and detail views remain usable immediately after intake."
@@ -150920,8 +153420,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 700,
-              "end_line": 730,
+              "start_line": 713,
+              "end_line": 743,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Project partial Superset intake recovery into explicit findings without blocking session usability.",
@@ -150943,17 +153443,17 @@
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 700
+                    "line_number": 713
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 700
+                    "line_number": 713
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 700
+                    "line_number": 713
                   }
                 ],
                 "score": 0.0
@@ -150964,8 +153464,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 732,
-              "end_line": 889,
+              "start_line": 745,
+              "end_line": 905,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Recover and materialize initial imported filters, template variables, and draft execution mappings after session creation.",
@@ -150996,8 +153496,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 891,
-              "end_line": 904,
+              "start_line": 907,
+              "end_line": 920,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Separate normalized filter payload metadata from the user-facing effective filter value."
@@ -151015,8 +153515,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 906,
-              "end_line": 1042,
+              "start_line": 922,
+              "end_line": 1058,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Build effective filters, template params, approvals, and fingerprint for preview and launch gating.",
@@ -151038,17 +153538,17 @@
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 906
+                    "line_number": 922
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 906
+                    "line_number": 922
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 906
+                    "line_number": 922
                   }
                 ],
                 "score": 0.0
@@ -151059,8 +153559,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 1044,
-              "end_line": 1085,
+              "start_line": 1060,
+              "end_line": 1101,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Enforce launch gates from findings, approvals, and current preview truth.",
@@ -151082,17 +153582,17 @@
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 1044
+                    "line_number": 1060
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 1044
+                    "line_number": 1060
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 1044
+                    "line_number": 1060
                   }
                 ],
                 "score": 0.0
@@ -151103,8 +153603,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 1087,
-              "end_line": 1106,
+              "start_line": 1103,
+              "end_line": 1122,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Resolve the current latest preview snapshot for one session aggregate."
@@ -151122,8 +153622,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 1108,
-              "end_line": 1115,
+              "start_line": 1124,
+              "end_line": 1131,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Produce deterministic execution fingerprint for preview truth and staleness checks."
@@ -151141,8 +153641,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 1117,
-              "end_line": 1175,
+              "start_line": 1133,
+              "end_line": 1191,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Link session start to observable async recovery when task infrastructure is available.",
@@ -151176,8 +153676,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 179,
-          "end_line": 179,
+          "start_line": 181,
+          "end_line": 181,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -151200,7 +153700,7 @@
             "line_number": 1
           },
           {
-            "message": "Fractal limit warning: Module length is 1180 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 1196 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -151245,7 +153745,7 @@
       "complexity": 4,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 552,
+      "end_line": 635,
       "tags": {
         "COMPLEXITY": "4",
         "SEMANTICS": "dataset_review, clarification, question_payload, answer_persistence, readiness, findings",
@@ -151302,7 +153802,7 @@
           "complexity": 2,
           "tier": "TRIVIAL",
           "start_line": 48,
-          "end_line": 62,
+          "end_line": 64,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Typed active-question payload returned to the API layer."
@@ -151320,8 +153820,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 65,
-          "end_line": 74,
+          "start_line": 67,
+          "end_line": 78,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Clarification state result carrying the current session, active payload, and changed findings."
@@ -151339,8 +153839,8 @@
           "type": "Class",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 77,
-          "end_line": 87,
+          "start_line": 81,
+          "end_line": 93,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Typed answer command for clarification state mutation."
@@ -151358,8 +153858,8 @@
           "type": "Class",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 90,
-          "end_line": 550,
+          "start_line": 96,
+          "end_line": 633,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Provide deterministic one-question-at-a-time clarification selection and answer persistence.",
@@ -151387,8 +153887,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 100,
-              "end_line": 105,
+              "start_line": 106,
+              "end_line": 112,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Bind repository dependency for clarification persistence operations."
@@ -151406,8 +153906,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 107,
-              "end_line": 200,
+              "start_line": 114,
+              "end_line": 219,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Return the one active highest-priority clarification question payload with why-it-matters, current guess, and options.",
@@ -151438,8 +153938,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 202,
-              "end_line": 329,
+              "start_line": 221,
+              "end_line": 376,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Persist one clarification answer before any pointer/readiness mutation and compute deterministic state impact.",
@@ -151470,8 +153970,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 331,
-              "end_line": 339,
+              "start_line": 378,
+              "end_line": 387,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Produce a compact progress summary for pause/resume and completion UX."
@@ -151494,8 +153994,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 341,
-              "end_line": 356,
+              "start_line": 389,
+              "end_line": 405,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Select the latest clarification session for the current dataset review aggregate."
@@ -151513,8 +154013,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 358,
-              "end_line": 370,
+              "start_line": 407,
+              "end_line": 420,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Resolve a clarification question from the active clarification aggregate."
@@ -151532,8 +154032,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 372,
-              "end_line": 387,
+              "start_line": 422,
+              "end_line": 441,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Select the next unresolved question in deterministic priority order."
@@ -151551,8 +154051,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 389,
-              "end_line": 398,
+              "start_line": 443,
+              "end_line": 455,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Count questions whose answers fully resolved the ambiguity."
@@ -151570,8 +154070,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 400,
-              "end_line": 409,
+              "start_line": 457,
+              "end_line": 470,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Count questions still unresolved or deferred after clarification interaction."
@@ -151589,8 +154089,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 411,
-              "end_line": 432,
+              "start_line": 472,
+              "end_line": 503,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Validate and normalize answer payload based on answer kind and active question options."
@@ -151608,8 +154108,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 434,
-              "end_line": 448,
+              "start_line": 505,
+              "end_line": 520,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Build a compact audit note describing how the clarification answer affects session state."
@@ -151627,8 +154127,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 450,
-              "end_line": 516,
+              "start_line": 522,
+              "end_line": 593,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Keep one finding per clarification topic aligned with answer outcome and unresolved visibility rules."
@@ -151651,8 +154151,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 518,
-              "end_line": 535,
+              "start_line": 595,
+              "end_line": 613,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Recompute readiness after clarification mutation while preserving unresolved visibility semantics."
@@ -151679,8 +154179,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 537,
-              "end_line": 549,
+              "start_line": 615,
+              "end_line": 630,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "Recompute next-action guidance after clarification mutations."
@@ -151705,8 +154205,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 103,
-          "end_line": 103,
+          "start_line": 109,
+          "end_line": 109,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -151724,7 +154224,7 @@
         "valid": true,
         "issues": [
           {
-            "message": "Fractal limit warning: Module length is 552 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 635 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -151738,7 +154238,7 @@
       "complexity": 5,
       "tier": "CRITICAL",
       "start_line": 1,
-      "end_line": 415,
+      "end_line": 514,
       "tags": {
         "COMPLEXITY": "5",
         "PURPOSE": "Persist and retrieve dataset review session aggregates, including readiness, findings, semantic decisions, clarification state, previews, and run contexts.",
@@ -151768,13 +154268,32 @@
         }
       ],
       "children": [
+        {
+          "name": "DatasetReviewSessionVersionConflictError",
+          "type": "Class",
+          "complexity": 2,
+          "tier": "TRIVIAL",
+          "start_line": 40,
+          "end_line": 53,
+          "tags": {
+            "COMPLEXITY": "2",
+            "PURPOSE": "Signal optimistic-lock conflicts for dataset review session mutations."
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "DatasetReviewSessionRepository",
           "type": "Class",
           "complexity": 4,
           "tier": "STANDARD",
-          "start_line": 37,
-          "end_line": 413,
+          "start_line": 56,
+          "end_line": 512,
           "tags": {
             "COMPLEXITY": "4",
             "PURPOSE": "Enforce ownership-scoped persistence and retrieval for dataset review session aggregates.",
@@ -151811,8 +154330,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 50,
-              "end_line": 57,
+              "start_line": 69,
+              "end_line": 76,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Bind one live SQLAlchemy session to the repository instance."
@@ -151825,77 +154344,77 @@
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @RELATION (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   },
                   {
                     "message": "Missing Belief State Logging: Function should use belief_scope / molecular methods (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 50
+                    "line_number": 69
                   }
                 ],
                 "score": 0.0
@@ -151906,8 +154425,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 59,
-              "end_line": 93,
+              "start_line": 78,
+              "end_line": 112,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Resolve one owner-scoped dataset review session for mutation paths without leaking foreign-session state.",
@@ -151934,8 +154453,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 95,
-              "end_line": 121,
+              "start_line": 114,
+              "end_line": 140,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Persist an initial dataset review session shell.",
@@ -151957,13 +154476,69 @@
                 "score": 0.9400000000000001
               }
             },
+            {
+              "name": "require_session_version",
+              "type": "Function",
+              "complexity": 4,
+              "tier": "STANDARD",
+              "start_line": 142,
+              "end_line": 182,
+              "tags": {
+                "COMPLEXITY": "4",
+                "PURPOSE": "Enforce optimistic-lock version matching before a session mutation is persisted.",
+                "PRE": "session belongs to the current owner mutation scope and expected_version is the caller's last observed version.",
+                "POST": "returns the same session when versions match; otherwise raises deterministic conflict error.",
+                "SIDE_EFFECT": "none.",
+                "DATA_CONTRACT": "Input[DatasetReviewSession,int] -> Output[DatasetReviewSession|DatasetReviewSessionVersionConflictError]"
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "DatasetReviewSession"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.9400000000000001
+              }
+            },
+            {
+              "name": "bump_session_version",
+              "type": "Function",
+              "complexity": 4,
+              "tier": "STANDARD",
+              "start_line": 184,
+              "end_line": 204,
+              "tags": {
+                "COMPLEXITY": "4",
+                "PURPOSE": "Increment optimistic-lock version after a successful session mutation is assembled.",
+                "PRE": "session mutation has passed guards and will be committed in the current transaction.",
+                "POST": "session version increments monotonically and last_activity_at reflects the mutation time.",
+                "SIDE_EFFECT": "mutates the in-memory session aggregate before commit.",
+                "DATA_CONTRACT": "Input[DatasetReviewSession] -> Output[int]"
+              },
+              "relations": [
+                {
+                  "type": "DEPENDS_ON",
+                  "target": "DatasetReviewSession"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 0.9400000000000001
+              }
+            },
             {
               "name": "load_detail",
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 123,
-              "end_line": 182,
+              "start_line": 206,
+              "end_line": 265,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Return the full session aggregate for API and frontend resume flows."
@@ -151985,47 +154560,47 @@
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 123
+                    "line_number": 206
                   }
                 ],
                 "score": 0.0
@@ -152036,8 +154611,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 184,
-              "end_line": 242,
+              "start_line": 267,
+              "end_line": 329,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Persist profile state and replace validation findings for an owned session in one transaction.",
@@ -152072,8 +154647,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 244,
-              "end_line": 308,
+              "start_line": 331,
+              "end_line": 401,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Persist imported filters, template variables, and initial execution mappings for one owned session."
@@ -152099,47 +154674,47 @@
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @PRE (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @POST (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   },
                   {
                     "message": "Missing Mandatory Tag: @SIDE_EFFECT (required for complexity 4)",
                     "severity": "ERROR",
-                    "line_number": 244
+                    "line_number": 331
                   }
                 ],
                 "score": 0.0
@@ -152150,8 +154725,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 310,
-              "end_line": 349,
+              "start_line": 403,
+              "end_line": 445,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Persist a preview snapshot and mark prior session previews stale.",
@@ -152182,8 +154757,8 @@
               "type": "Function",
               "complexity": 4,
               "tier": "STANDARD",
-              "start_line": 351,
-              "end_line": 386,
+              "start_line": 447,
+              "end_line": 485,
               "tags": {
                 "COMPLEXITY": "4",
                 "PURPOSE": "Persist an immutable launch audit snapshot for an owned session.",
@@ -152214,8 +154789,8 @@
               "type": "Function",
               "complexity": 2,
               "tier": "TRIVIAL",
-              "start_line": 388,
-              "end_line": 410,
+              "start_line": 487,
+              "end_line": 509,
               "tags": {
                 "COMPLEXITY": "2",
                 "PURPOSE": "List review sessions owned by a specific user ordered by most recent update."
@@ -152245,8 +154820,27 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 53,
-          "end_line": 53,
+          "start_line": 44,
+          "end_line": 44,
+          "tags": {
+            "PURPOSE": "Auto-detected function (orphan)",
+            "COMPLEXITY": "1"
+          },
+          "relations": [],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "__init__",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 72,
+          "end_line": 72,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152264,8 +154858,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 67,
-          "end_line": 67,
+          "start_line": 86,
+          "end_line": 86,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152283,8 +154877,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 103,
-          "end_line": 103,
+          "start_line": 122,
+          "end_line": 122,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152302,8 +154896,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 128,
-          "end_line": 128,
+          "start_line": 211,
+          "end_line": 211,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152321,8 +154915,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 194,
-          "end_line": 194,
+          "start_line": 277,
+          "end_line": 277,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152340,8 +154934,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 319,
-          "end_line": 319,
+          "start_line": 412,
+          "end_line": 412,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152359,8 +154953,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 360,
-          "end_line": 360,
+          "start_line": 456,
+          "end_line": 456,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152378,8 +154972,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 392,
-          "end_line": 392,
+          "start_line": 491,
+          "end_line": 491,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152402,7 +154996,7 @@
             "line_number": 1
           },
           {
-            "message": "Fractal limit warning: Module length is 415 lines (must be < 300)",
+            "message": "Fractal limit warning: Module length is 514 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -152415,8 +155009,8 @@
       "type": "Module",
       "complexity": 2,
       "tier": "TRIVIAL",
-      "start_line": 25,
-      "end_line": 311,
+      "start_line": 28,
+      "end_line": 615,
       "tags": {
         "COMPLEXITY": "2",
         "PURPOSE": "Unit tests for DatasetReviewSessionRepository."
@@ -152433,8 +155027,8 @@
           "type": "Function",
           "complexity": 2,
           "tier": "TRIVIAL",
-          "start_line": 33,
-          "end_line": 56,
+          "start_line": 36,
+          "end_line": 59,
           "tags": {
             "COMPLEXITY": "2",
             "PURPOSE": "Build isolated in-memory SQLAlchemy session seeded with baseline user/environment rows."
@@ -152457,8 +155051,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 59,
-          "end_line": 82,
+          "start_line": 62,
+          "end_line": 86,
           "tags": {
             "PURPOSE": "Verify session creation and persistence."
           },
@@ -152475,13 +155069,82 @@
             "score": 1.0
           }
         },
+        {
+          "name": "test_require_session_version_conflict",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 89,
+          "end_line": 111,
+          "tags": {
+            "PURPOSE": "Verify optimistic-lock conflict is raised when caller version is stale."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "SessionRepositoryTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "test_bump_session_version_updates_last_activity",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 114,
+          "end_line": 136,
+          "tags": {
+            "PURPOSE": "Verify repository version bump increments monotonically and refreshes last activity."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "SessionRepositoryTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
+        {
+          "name": "test_save_recovery_state_preserves_raw_value_masked_flag",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 139,
+          "end_line": 177,
+          "tags": {
+            "PURPOSE": "Verify imported-filter masking metadata persists with recovery bootstrap state."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "SessionRepositoryTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "test_load_session_detail_ownership",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 85,
-          "end_line": 108,
+          "start_line": 180,
+          "end_line": 203,
           "tags": {
             "PURPOSE": "Verify ownership enforcement in detail loading."
           },
@@ -152503,8 +155166,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 111,
-          "end_line": 145,
+          "start_line": 206,
+          "end_line": 240,
           "tags": {
             "PURPOSE": "Verify collaborator access in detail loading."
           },
@@ -152526,8 +155189,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 148,
-          "end_line": 178,
+          "start_line": 243,
+          "end_line": 273,
           "tags": {
             "PURPOSE": "Verify that saving a new preview marks old ones as stale."
           },
@@ -152544,13 +155207,36 @@
             "score": 1.0
           }
         },
+        {
+          "name": "test_save_preview_increments_session_version_once_per_call",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 276,
+          "end_line": 315,
+          "tags": {
+            "PURPOSE": "Verify preview persistence itself contributes exactly one optimistic-lock version increment so higher orchestration layers do not need to bump again for the same preview mutation."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "SessionRepositoryTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "test_save_profile_and_findings",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 181,
-          "end_line": 237,
+          "start_line": 318,
+          "end_line": 374,
           "tags": {
             "PURPOSE": "Verify persistence of profile and findings."
           },
@@ -152572,8 +155258,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 240,
-          "end_line": 272,
+          "start_line": 377,
+          "end_line": 409,
           "tags": {
             "PURPOSE": "Verify saving of run context."
           },
@@ -152590,13 +155276,36 @@
             "score": 1.0
           }
         },
+        {
+          "name": "test_ensure_dataset_review_session_columns_adds_missing_legacy_columns",
+          "type": "Function",
+          "complexity": 1,
+          "tier": "TRIVIAL",
+          "start_line": 412,
+          "end_line": 576,
+          "tags": {
+            "PURPOSE": "Verify additive dataset review migration creates missing legacy columns for session and imported-filter tables without dropping rows."
+          },
+          "relations": [
+            {
+              "type": "BINDS_TO",
+              "target": "SessionRepositoryTests"
+            }
+          ],
+          "children": [],
+          "compliance": {
+            "valid": true,
+            "issues": [],
+            "score": 1.0
+          }
+        },
         {
           "name": "test_list_sessions_for_user",
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 275,
-          "end_line": 310,
+          "start_line": 579,
+          "end_line": 614,
           "tags": {
             "PURPOSE": "Verify listing of sessions by user."
           },
@@ -152618,8 +155327,8 @@
           "type": "Function",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 32,
-          "end_line": 32,
+          "start_line": 35,
+          "end_line": 35,
           "tags": {
             "PURPOSE": "Auto-detected function (orphan)",
             "COMPLEXITY": "1"
@@ -152639,10 +155348,15 @@
           {
             "message": "Invalid @RELATION predicate: BELONGS_TO. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
             "severity": "WARNING",
-            "line_number": 25
+            "line_number": 28
+          },
+          {
+            "message": "Fractal limit warning: Module length is 588 lines (must be < 300)",
+            "severity": "WARNING",
+            "line_number": 28
           }
         ],
-        "score": 0.85
+        "score": 0.7
       }
     },
     {
@@ -159078,7 +161792,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 290,
+      "end_line": 310,
       "tags": {
         "COMPLEXITY": "3",
         "SEMANTICS": "tests, resource-hubs, dashboards, datasets, pagination, api",
@@ -159087,22 +161801,27 @@
       },
       "relations": [
         {
-          "type": "BELONGS_TO",
-          "target": "SrcRoot"
+          "type": "DEPENDS_ON",
+          "target": "DashboardsApi"
+        },
+        {
+          "type": "DEPENDS_ON",
+          "target": "DatasetsApi"
         }
       ],
       "children": [
         {
           "name": "test_dashboards_api",
-          "type": "Test",
+          "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 20,
-          "end_line": 131,
+          "start_line": 21,
+          "end_line": 141,
           "tags": {
             "PURPOSE": "Verify GET /api/dashboards contract compliance",
-            "TEST": "Search filter works",
-            "INVARIANT": "unconstrained mock \u2014 no spec= enforced; attribute typos will silently pass"
+            "TEST_CONTRACT": "dashboards_query -> dashboards payload or not_found response",
+            "TEST_SCENARIO": "dashboards_search_filters_results -> Search narrows payload to matching dashboard title.",
+            "TEST_INVARIANT": "dashboards_route_contract_stays_observable -> VERIFIED_BY: [dashboards_env_found_returns_payload, dashboards_unknown_env_returns_not_found, dashboards_search_filters_results]"
           },
           "relations": [
             {
@@ -159111,13 +161830,38 @@
             }
           ],
           "children": [
+            {
+              "name": "mock_deps",
+              "type": "Function",
+              "complexity": 1,
+              "tier": "TRIVIAL",
+              "start_line": 31,
+              "end_line": 99,
+              "tags": {
+                "PURPOSE": "Provide dependency override fixture for resource hub route tests.",
+                "TEST_FIXTURE": "resource_hub_overrides -> INLINE_JSON",
+                "INVARIANT": "unconstrained mock \u2014 no spec= enforced; attribute typos will silently pass"
+              },
+              "relations": [
+                {
+                  "type": "BINDS_TO",
+                  "target": "TestResourceHubs"
+                }
+              ],
+              "children": [],
+              "compliance": {
+                "valid": true,
+                "issues": [],
+                "score": 1.0
+              }
+            },
             {
               "name": "test_get_dashboards_success",
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 92,
-              "end_line": 105,
+              "start_line": 102,
+              "end_line": 115,
               "tags": {
                 "PURPOSE": "Verify dashboards endpoint returns 200 with expected dashboard payload fields."
               },
@@ -159139,8 +161883,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 108,
-              "end_line": 116,
+              "start_line": 118,
+              "end_line": 126,
               "tags": {
                 "PURPOSE": "Verify dashboards endpoint returns 404 for unknown environment identifier."
               },
@@ -159162,8 +161906,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 119,
-              "end_line": 130,
+              "start_line": 129,
+              "end_line": 140,
               "tags": {
                 "PURPOSE": "Verify dashboards endpoint search filter returns matching subset."
               },
@@ -159189,14 +161933,16 @@
         },
         {
           "name": "test_datasets_api",
-          "type": "Test",
+          "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 134,
-          "end_line": 232,
+          "start_line": 144,
+          "end_line": 244,
           "tags": {
             "PURPOSE": "Verify GET /api/datasets contract compliance",
-            "TEST": "Negative - Service failure returns 503"
+            "TEST_CONTRACT": "datasets_query -> datasets payload or error response",
+            "TEST_SCENARIO": "datasets_service_failure_returns_503 -> Backend fetch failure surfaces as HTTP 503.",
+            "TEST_INVARIANT": "datasets_route_contract_stays_observable -> VERIFIED_BY: [datasets_env_found_returns_payload, datasets_unknown_env_returns_not_found, datasets_search_filters_results, datasets_service_failure_returns_503]"
           },
           "relations": [
             {
@@ -159210,8 +161956,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 143,
-              "end_line": 169,
+              "start_line": 155,
+              "end_line": 181,
               "tags": {
                 "PURPOSE": "Verify datasets endpoint returns 200 with mapped fields payload."
               },
@@ -159233,8 +161979,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 172,
-              "end_line": 180,
+              "start_line": 184,
+              "end_line": 192,
               "tags": {
                 "PURPOSE": "Verify datasets endpoint returns 404 for unknown environment identifier."
               },
@@ -159256,8 +162002,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 183,
-              "end_line": 215,
+              "start_line": 195,
+              "end_line": 227,
               "tags": {
                 "PURPOSE": "Verify datasets endpoint search filter returns matching dataset subset."
               },
@@ -159279,8 +162025,8 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 218,
-              "end_line": 231,
+              "start_line": 230,
+              "end_line": 243,
               "tags": {
                 "PURPOSE": "Verify datasets endpoint surfaces backend fetch failure as HTTP 503."
               },
@@ -159306,14 +162052,17 @@
         },
         {
           "name": "test_pagination_boundaries",
-          "type": "Test",
+          "type": "Block",
           "complexity": 1,
           "tier": "TRIVIAL",
-          "start_line": 235,
-          "end_line": 289,
+          "start_line": 247,
+          "end_line": 309,
           "tags": {
             "PURPOSE": "Verify pagination validation for GET endpoints",
-            "TEST": "page<1 and page_size>100 return 400"
+            "TEST_CONTRACT": "pagination_query -> validation error response",
+            "TEST_SCENARIO": "datasets_oversize_page_rejected -> page_size=101 returns HTTP 400.",
+            "TEST_EDGE": "external_fail -> Validation failure returns HTTP 400 without partial payload.",
+            "TEST_INVARIANT": "pagination_limits_apply_to_both_routes -> VERIFIED_BY: [dashboards_zero_page_rejected, dashboards_oversize_page_rejected, datasets_zero_page_rejected, datasets_oversize_page_rejected]"
           },
           "relations": [
             {
@@ -159327,10 +162076,11 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 241,
-              "end_line": 251,
+              "start_line": 261,
+              "end_line": 271,
               "tags": {
-                "PURPOSE": "Verify dashboards endpoint rejects page=0 with HTTP 400 validation error."
+                "PURPOSE": "Verify dashboards endpoint rejects page=0 with HTTP 400 validation error.",
+                "TEST_EDGE": "pagination_zero_page -> {page: 0, status: 400}"
               },
               "relations": [
                 {
@@ -159350,10 +162100,11 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 254,
-              "end_line": 264,
+              "start_line": 274,
+              "end_line": 284,
               "tags": {
-                "PURPOSE": "Verify dashboards endpoint rejects oversized page_size with HTTP 400."
+                "PURPOSE": "Verify dashboards endpoint rejects oversized page_size with HTTP 400.",
+                "TEST_EDGE": "pagination_oversize -> {page_size: 101, status: 400}"
               },
               "relations": [
                 {
@@ -159373,10 +162124,11 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 267,
-              "end_line": 276,
+              "start_line": 287,
+              "end_line": 296,
               "tags": {
-                "PURPOSE": "Verify datasets endpoint rejects page=0 with HTTP 400."
+                "PURPOSE": "Verify datasets endpoint rejects page=0 with HTTP 400.",
+                "TEST_EDGE": "pagination_zero_page_datasets -> {page: 0, status: 400}"
               },
               "relations": [
                 {
@@ -159396,10 +162148,11 @@
               "type": "Function",
               "complexity": 1,
               "tier": "TRIVIAL",
-              "start_line": 279,
-              "end_line": 288,
+              "start_line": 299,
+              "end_line": 308,
               "tags": {
-                "PURPOSE": "Verify datasets endpoint rejects oversized page_size with HTTP 400."
+                "PURPOSE": "Verify datasets endpoint rejects oversized page_size with HTTP 400.",
+                "TEST_EDGE": "pagination_oversize_datasets -> {page_size: 101, status: 400}"
               },
               "relations": [
                 {
@@ -159420,32 +162173,13 @@
             "issues": [],
             "score": 1.0
           }
-        },
-        {
-          "name": "mock_deps",
-          "type": "Function",
-          "complexity": 1,
-          "tier": "TRIVIAL",
-          "start_line": 29,
-          "end_line": 29,
-          "tags": {
-            "PURPOSE": "Auto-detected function (orphan)",
-            "COMPLEXITY": "1"
-          },
-          "relations": [],
-          "children": [],
-          "compliance": {
-            "valid": true,
-            "issues": [],
-            "score": 1.0
-          }
         }
       ],
       "compliance": {
         "valid": true,
         "issues": [
           {
-            "message": "Invalid @RELATION predicate: BELONGS_TO. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
+            "message": "Fractal limit warning: Module length is 310 lines (must be < 300)",
             "severity": "WARNING",
             "line_number": 1
           }
@@ -162188,7 +164922,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 130,
+      "end_line": 135,
       "tags": {
         "COMPLEXITY": "3",
         "PURPOSE": "Unit tests for MigrationDryRunService diff and risk computation contracts.",
@@ -162196,7 +164930,7 @@
       },
       "relations": [
         {
-          "type": "VERIFIES",
+          "type": "DEPENDS_ON",
           "target": "MigrationDryRunOrchestratorModule"
         }
       ],
@@ -162253,12 +164987,14 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 56,
-          "end_line": 129,
+          "end_line": 134,
           "tags": {
             "PURPOSE": "Verify dry-run orchestration returns stable diff summary and required risk codes.",
+            "TEST_SCENARIO": "dry_run_builds_diff_and_risk -> Stable diff summary and required risk codes are returned.",
+            "TEST_EDGE": "breaking_reference -> fixture.transformed_zip_objects.charts[0].dataset_uuid",
+            "TEST_INVARIANT": "dry_run_result_contract_matches_fixture -> VERIFIED_BY: [dry_run_builds_diff_and_risk]",
             "TEST_CONTRACT": "dry_run_result_contract -> {",
-            "TEST_FIXTURE": "migration_dry_run_fixture -> backend/tests/fixtures/migration_dry_run_fixture.json",
-            "TEST_EDGE": "breaking_reference -> fixture.transformed_zip_objects.charts[0].dataset_uuid"
+            "TEST_FIXTURE": "migration_dry_run_fixture -> backend/tests/fixtures/migration_dry_run_fixture.json"
           },
           "relations": [
             {
@@ -162281,14 +165017,9 @@
             "message": "Missing Mandatory Tag: @SEMANTICS (required for complexity 3)",
             "severity": "WARNING",
             "line_number": 1
-          },
-          {
-            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 1
           }
         ],
-        "score": 0.5499999999999999
+        "score": 0.7
       }
     },
     {
@@ -162297,7 +165028,7 @@
       "complexity": 3,
       "tier": "STANDARD",
       "start_line": 1,
-      "end_line": 74,
+      "end_line": 79,
       "tags": {
         "COMPLEXITY": "3",
         "PURPOSE": "Unit tests for MigrationArchiveParser ZIP extraction contract.",
@@ -162305,8 +165036,8 @@
       },
       "relations": [
         {
-          "type": "VERIFIES",
-          "target": "backend.src.core.migration.archive_parser"
+          "type": "DEPENDS_ON",
+          "target": "MigrationArchiveParserModule"
         }
       ],
       "children": [
@@ -162316,9 +165047,12 @@
           "complexity": 1,
           "tier": "TRIVIAL",
           "start_line": 23,
-          "end_line": 73,
+          "end_line": 78,
           "tags": {
-            "PURPOSE": "Verify archive parser collects dashboard/chart/dataset YAML objects into typed buckets."
+            "PURPOSE": "Verify archive parser collects dashboard/chart/dataset YAML objects into typed buckets.",
+            "TEST_CONTRACT": "zip_archive_fixture -> typed dashboard/chart/dataset extraction buckets",
+            "TEST_SCENARIO": "archive_with_supported_objects_extracts_all_types -> One YAML file per supported type lands in matching bucket.",
+            "TEST_EDGE": "external_fail -> Corrupt archive would fail extraction before typed buckets are returned."
           },
           "relations": [
             {
@@ -162341,14 +165075,9 @@
             "message": "Missing Mandatory Tag: @SEMANTICS (required for complexity 3)",
             "severity": "WARNING",
             "line_number": 1
-          },
-          {
-            "message": "Invalid @RELATION predicate: VERIFIES. Allowed: BINDS_TO, CALLS, DEPENDS_ON, DISPATCHES, IMPLEMENTS, INHERITS",
-            "severity": "WARNING",
-            "line_number": 1
           }
         ],
-        "score": 0.5499999999999999
+        "score": 0.7
       }
     },
     {
diff --git a/specs/001-unify-frontend-style/contracts/modules.md b/specs/001-unify-frontend-style/contracts/modules.md
index 609103d3..ce0452d1 100644
--- a/specs/001-unify-frontend-style/contracts/modules.md
+++ b/specs/001-unify-frontend-style/contracts/modules.md
@@ -1,65 +1,79 @@
 # Module Contracts: Frontend Style Unification
 
-## [DEF:FrontendStyleSystem:Module]
-@TIER: CRITICAL  
-@PURPOSE: Define and enforce unified visual primitives and page-shell rules across targeted frontend routes.  
-@RELATION: DEPENDS_ON -> [DEF:Std:UI_Svelte]  
-@RELATION: DEPENDS_ON -> [DEF:Std:Semantics]  
-@RELATION: BINDS_TO -> [DEF:StyleTokenGroup:Entity]  
-@RELATION: BINDS_TO -> [DEF:UIPatternRule:Entity]  
-@PRE: Target routes/components for unification are identified and included in scope.  
-@PRE: Existing behavior-critical user flows remain available for validation.  
-@POST: Shared visual primitives and shell patterns are applied consistently in targeted scope.  
-@POST: No critical functional flow is removed by style refactor.  
-@UX_STATE: Default -> Users see consistent hierarchy (title/actions/content) across targeted pages.  
-@UX_STATE: Loading -> Loading visuals appear in consistent zones without disruptive layout jumps.  
-@UX_STATE: Error -> Error blocks use consistent emphasis and include a clear recovery action.  
-@UX_STATE: Success -> Confirmation messages follow one tone/placement pattern.  
-@INVARIANT: Unified styling must not regress accessibility-visible focus and readable contrast behavior.
+# [DEF:FrontendStyleSystem:Module]
+# @TIER: CRITICAL
+# @PURPOSE: Define and enforce unified visual primitives and page-shell rules across targeted frontend routes.
+# @RELATION: DEPENDS_ON -> [DEF:Std:UI_Svelte:Standard]
+# @RELATION: DEPENDS_ON -> [DEF:Std:Semantics:Standard]
+# @RELATION: BINDS_TO -> [DEF:StyleTokenGroup:Block]
+# @RELATION: BINDS_TO -> [DEF:UIPatternRule:Block]
+# @PRE: Target routes/components for unification are identified and included in scope.
+# @PRE: Existing behavior-critical user flows remain available for validation.
+# @POST: Shared visual primitives and shell patterns are applied consistently in targeted scope.
+# @POST: No critical functional flow is removed by style refactor.
+# @UX_STATE: Default -> Users see consistent hierarchy (title/actions/content) across targeted pages.
+# @UX_STATE: Loading -> Loading visuals appear in consistent zones without disruptive layout jumps.
+# @UX_STATE: Error -> Error blocks use consistent emphasis and include a clear recovery action.
+# @UX_STATE: Success -> Confirmation messages follow one tone/placement pattern.
+# @INVARIANT: Unified styling must not regress accessibility-visible focus and readable contrast behavior.
 
 ---
 
-## [DEF:RouteShellContract:Component]
-@TIER: CRITICAL  
-@PURPOSE: Standardize route shell structure for primary pages (dashboards, tasks, reports, settings).  
-@RELATION: DEPENDS_ON -> [DEF:FrontendStyleSystem:Module]  
-@PRE: Route provides title context and action area metadata.  
-@POST: Route renders canonical shell order: context/breadcrumbs, title block, action region, content container.  
-@UX_STATE: Default -> Primary action location is discoverable quickly and consistently.  
-@UX_STATE: Empty -> Empty-state container is visually aligned with shell and includes next-step guidance.  
-@UX_RECOVERY: Empty -> User can recover using explicit action (refresh/filter adjust/create flow).
+# [/DEF:FrontendStyleSystem:Module]
+
+##
+
+# [DEF:RouteShellContract:Component]
+# @TIER: CRITICAL
+# @PURPOSE: Standardize route shell structure for primary pages (dashboards, tasks, reports, settings).
+# @RELATION: DEPENDS_ON -> [DEF:FrontendStyleSystem:Module]
+# @PRE: Route provides title context and action area metadata.
+# @POST: Route renders canonical shell order: context/breadcrumbs, title block, action region, content container.
+# @UX_STATE: Default -> Primary action location is discoverable quickly and consistently.
+# @UX_STATE: Empty -> Empty-state container is visually aligned with shell and includes next-step guidance.
+# @UX_RECOVERY: Empty -> User can recover using explicit action (refresh/filter adjust/create flow).
 
 ---
 
-## [DEF:StateFeedbackContract:Component]
-@TIER: CRITICAL  
-@PURPOSE: Normalize loading/empty/error/success feedback rendering and wording across modules.  
-@RELATION: DEPENDS_ON -> [DEF:StatePresentationPattern:Entity]  
-@PRE: Module can expose current state category (loading/empty/error/success).  
-@POST: State-specific UI uses canonical placement, tone, and recovery behavior.  
-@UX_STATE: Loading -> Consistent indicator style and placement with stable layout rhythm.  
-@UX_STATE: Empty -> Neutral message + guidance action rendered in standard block.  
-@UX_STATE: Error -> Actionable error messaging with retry/fix path.  
-@UX_STATE: Success -> Concise confirmation in standard visual language.  
-@UX_FEEDBACK: Error -> Emphasis clearly distinguishes failure from neutral status.  
-@UX_RECOVERY: Error -> Retry or corrective action is always visible when recoverable.  
-@INVARIANT: State texts use canonical terminology and remain i18n-compatible.
+# [/DEF:RouteShellContract:Component]
+
+##
+
+# [DEF:StateFeedbackContract:Component]
+# @TIER: CRITICAL
+# @PURPOSE: Normalize loading/empty/error/success feedback rendering and wording across modules.
+# @RELATION: DEPENDS_ON -> [DEF:StatePresentationPattern:Block]
+# @PRE: Module can expose current state category (loading/empty/error/success).
+# @POST: State-specific UI uses canonical placement, tone, and recovery behavior.
+# @UX_STATE: Loading -> Consistent indicator style and placement with stable layout rhythm.
+# @UX_STATE: Empty -> Neutral message + guidance action rendered in standard block.
+# @UX_STATE: Error -> Actionable error messaging with retry/fix path.
+# @UX_STATE: Success -> Concise confirmation in standard visual language.
+# @UX_FEEDBACK: Error -> Emphasis clearly distinguishes failure from neutral status.
+# @UX_RECOVERY: Error -> Retry or corrective action is always visible when recoverable.
+# @INVARIANT: State texts use canonical terminology and remain i18n-compatible.
 
 ---
 
-## [DEF:TerminologyConsistencyContract:Module]
-@TIER: STANDARD  
-@PURPOSE: Keep user-facing wording consistent across page shells and state blocks.  
-@RELATION: DEPENDS_ON -> [DEF:Std:Constitution]  
-@PRE: Canonical term list for targeted flows is defined.  
-@POST: Targeted modules avoid mixed synonyms for the same concept.  
-@UX_STATE: Default -> UI labels and status texts remain concise and confidence-building.  
-@INVARIANT: User-facing text remains compatible with existing localization workflow.
+# [/DEF:StateFeedbackContract:Component]
+
+##
+
+# [DEF:TerminologyConsistencyContract:Module]
+# @TIER: STANDARD
+# @PURPOSE: Keep user-facing wording consistent across page shells and state blocks.
+# @RELATION: DEPENDS_ON -> [DEF:Std:Constitution:Standard]
+# @PRE: Canonical term list for targeted flows is defined.
+# @POST: Targeted modules avoid mixed synonyms for the same concept.
+# @UX_STATE: Default -> UI labels and status texts remain concise and confidence-building.
+# @INVARIANT: User-facing text remains compatible with existing localization workflow.
 
 ---
 
 ## Contract Usage Simulation (Key Scenario)
 
+# [/DEF:TerminologyConsistencyContract:Module]
+
 **Scenario**: User navigates from dashboards to reports and encounters a failed data load.
 
 1. `RouteShellContract` ensures both pages keep identical shell rhythm and action placement.
@@ -67,4 +81,4 @@
 3. `StateFeedbackContract` renders failure using canonical error block with explicit retry action.
 4. `TerminologyConsistencyContract` ensures error wording and action labels are aligned across pages.
 
-**Continuity Check**: No interface mismatch detected between shell-level structure and state-level feedback contracts.
\ No newline at end of file
+**Continuity Check**: No interface mismatch detected between shell-level structure and state-level feedback contracts.
diff --git a/specs/015-frontend-nav-redesign/plan.md b/specs/015-frontend-nav-redesign/plan.md
index cbc36ccd..38b630a8 100644
--- a/specs/015-frontend-nav-redesign/plan.md
+++ b/specs/015-frontend-nav-redesign/plan.md
@@ -1,6 +1,6 @@
 # Implementation Plan: Frontend Navigation Redesign
 
-**Branch**: `015-frontend-nav-redesign` | **Date**: 2026-01-26 | **Spec**: [specs/015-frontend-nav-redesign/spec.md](../spec.md)
+**Branch**: `015-frontend-nav-redesign` | **Date**: 2026-01-26 | **Spec**: [specs/015-frontend-nav-redesign/spec.md](./spec.md)
 **Input**: Feature specification from `specs/015-frontend-nav-redesign/spec.md`
 
 **Note**: This template is filled in by the `/speckit.plan` command. See `.specify/templates/commands/plan.md` for the execution workflow.
diff --git a/specs/015-frontend-nav-redesign/tasks.md b/specs/015-frontend-nav-redesign/tasks.md
index 63d7b7e1..d3e72c33 100644
--- a/specs/015-frontend-nav-redesign/tasks.md
+++ b/specs/015-frontend-nav-redesign/tasks.md
@@ -2,8 +2,8 @@
 
 **Feature Branch**: `015-frontend-nav-redesign`
 **Status**: Completed
-**Spec**: [specs/015-frontend-nav-redesign/spec.md](../spec.md)
-**Plan**: [specs/015-frontend-nav-redesign/plan.md](../plan.md)
+**Spec**: [specs/015-frontend-nav-redesign/spec.md](./spec.md)
+**Plan**: [specs/015-frontend-nav-redesign/plan.md](./plan.md)
 
 ## Phase 1: Setup
 
@@ -114,4 +114,4 @@
 1. **Setup**: Create the new directory structure.
 2. **Dashboard & Navbar**: Quick wins to reshape the navigation.
 3. **Backup UI**: The core development effort. Connect to existing backend.
-4. **Cleanup**: Remove old code once the new flows are verified.
\ No newline at end of file
+4. **Cleanup**: Remove old code once the new flows are verified.
diff --git a/specs/017-llm-analysis-plugin/contracts/modules.md b/specs/017-llm-analysis-plugin/contracts/modules.md
index a463059f..cddf6c8a 100644
--- a/specs/017-llm-analysis-plugin/contracts/modules.md
+++ b/specs/017-llm-analysis-plugin/contracts/modules.md
@@ -21,15 +21,15 @@
 # @PURPOSE: Analyze dashboard health using screenshot and logs.
 # @PRE: Dashboard ID exists and provider is configured.
 # @POST: ValidationResult is persisted and notification sent if failed.
-# [/DEF:validate_dashboard]
+# [/DEF:validate_dashboard:Function]
 
 # [DEF:generate_documentation:Function]
 # @PURPOSE: Generate and apply metadata descriptions for datasets.
 # @PRE: Dataset is accessible and schema is valid.
 # @POST: Dataset metadata is updated in the database.
-# [/DEF:generate_documentation]
+# [/DEF:generate_documentation:Function]
 
-# [/DEF:backend/src/plugins/llm_analysis/plugin.py]
+# [/DEF:backend/src/plugins/llm_analysis/plugin.py:Module]
 ```
 
 ### LLM Service
@@ -49,9 +49,9 @@
 # @PRE: Provider is active and quota is available.
 # @POST: Returns structured analysis or raises RetryError.
 # @SIDE_EFFECT: Makes external HTTP request.
-# [/DEF:analyze_multimodal]
+# [/DEF:analyze_multimodal:Function]
 
-# [/DEF:backend/src/plugins/llm_analysis/service.py]
+# [/DEF:backend/src/plugins/llm_analysis/service.py:Module]
 ```
 
 ### Provider Management Service
@@ -69,9 +69,9 @@
 # @PURPOSE: Instantiate an authenticated LLM client for a specific provider.
 # @PRE: Provider ID exists and is active.
 # @POST: Returns configured client instance with decrypted key.
-# [/DEF:get_provider_client]
+# [/DEF:get_provider_client:Function]
 
-# [/DEF:backend/src/services/llm_provider.py]
+# [/DEF:backend/src/services/llm_provider.py:Module]
 ```
 
 ### Data Models
@@ -82,7 +82,7 @@
 # @SEMANTICS: dto, pydantic, schema
 # @PURPOSE: Define Pydantic models for configuration, requests, and results.
 # @LAYER: Domain/Data
-# [/DEF:backend/src/plugins/llm_analysis/models.py]
+# [/DEF:backend/src/plugins/llm_analysis/models.py:Module]
 ```
 
 ## Frontend Components
@@ -94,7 +94,7 @@
 <!-- @TIER: STANDARD -->
 <!-- @PURPOSE: Form for adding/editing LLM providers with connection testing. -->
 <!-- @RELATION: CALLS -> /api/settings/llm/providers -->
-<!-- [/DEF:frontend/src/components/llm/ProviderConfig.svelte] -->
+<!-- [/DEF:frontend/src/components/llm/ProviderConfig.svelte:Component] -->
 ```
 
 ### Validation Report
@@ -104,4 +104,4 @@
 <!-- @TIER: STANDARD -->
 <!-- @PURPOSE: Display formatted analysis results including screenshot and issues list. -->
 <!-- @INVARIANT: Must handle missing screenshots gracefully. -->
-<!-- [/DEF:frontend/src/components/llm/ValidationReport.svelte] -->
\ No newline at end of file
+<!-- [/DEF:frontend/src/components/llm/ValidationReport.svelte:Component] -->
diff --git a/specs/019-superset-ux-redesign/contracts/api.md b/specs/019-superset-ux-redesign/contracts/api.md
index 55a2b3ab..b4b6896f 100644
--- a/specs/019-superset-ux-redesign/contracts/api.md
+++ b/specs/019-superset-ux-redesign/contracts/api.md
@@ -196,7 +196,7 @@ export const sidebarStore = writable({
 
 export function toggleSidebar() { /* ... */ }
 export function setActiveItem(path) { /* ... */ }
-// [/DEF:SidebarStore]
+// [/DEF:SidebarStore:Store]
 ```
 
 ### TaskDrawerStore (frontend/src/lib/stores/taskDrawer.js)
@@ -221,7 +221,7 @@ export const taskDrawerStore = writable({
 export function openDrawerForTask(taskId) { /* ... */ }
 export function closeDrawer() { /* ... */ }
 export function updateResourceTask(resourceId, taskId, status) { /* ... */ }
-// [/DEF:TaskDrawerStore]
+// [/DEF:TaskDrawerStore:Store]
 ```
 
 ### ActivityStore (frontend/src/lib/stores/activity.js)
@@ -238,5 +238,5 @@ export const activityStore = derived(taskDrawerStore, ($drawer) => {
     .filter(t => t.status === 'RUNNING').length;
   return { activeCount };
 });
-// [/DEF:ActivityStore]
+// [/DEF:ActivityStore:Store]
 ```
diff --git a/specs/019-superset-ux-redesign/contracts/modules.md b/specs/019-superset-ux-redesign/contracts/modules.md
index 02a02a33..480e8063 100644
--- a/specs/019-superset-ux-redesign/contracts/modules.md
+++ b/specs/019-superset-ux-redesign/contracts/modules.md
@@ -53,7 +53,7 @@ export function setActiveCategory(category) { /* ... */ }
 export function setActiveItem(path) { /* ... */ }
 export function openMobileSidebar() { /* ... */ }
 export function closeMobileSidebar() { /* ... */ }
-// [/DEF:SidebarStore]
+// [/DEF:SidebarStore:Store]
 ```
 
 ---
@@ -105,7 +105,7 @@ export function openDrawerForTask(taskId) { /* ... */ }
 export function closeDrawer() { /* ... */ }
 export function updateResourceTask(resourceId, taskId, status) { /* ... */ }
 export function clearCompletedTasks() { /* ... */ }
-// [/DEF:TaskDrawerStore]
+// [/DEF:TaskDrawerStore:Store]
 ```
 
 ---
@@ -143,7 +143,7 @@ export const activityStore = derived(
     return { activeCount, recentTasks };
   }
 );
-// [/DEF:ActivityStore]
+// [/DEF:ActivityStore:Store]
 ```
 
 ---
@@ -187,7 +187,7 @@ export const activityStore = derived(
     { id: 'admin', label: 'ADMIN', items: [{ path: '/users', label: 'Users' }, { path: '/settings', label: 'Settings' }], adminOnly: true }
   ];
 </script>
-<!-- [/DEF:Sidebar] -->
+<!-- [/DEF:Sidebar:Component] -->
 ```
 
 ---
@@ -225,7 +225,7 @@ export const activityStore = derived(
   export let logoText = 'Superset Tools';
   export let searchPlaceholder = 'Search...';
 </script>
-<!-- [/DEF:TopNavbar] -->
+<!-- [/DEF:TopNavbar:Component] -->
 ```
 
 ---
@@ -270,7 +270,7 @@ export const activityStore = derived(
   export let width = 480; // px
   export let closeOnOutsideClick = false;
 </script>
-<!-- [/DEF:TaskDrawer] -->
+<!-- [/DEF:TaskDrawer:Component] -->
 ```
 
 ---
@@ -323,7 +323,7 @@ export const activityStore = derived(
   let searchQuery = '';
   let environmentId = null;
 </script>
-<!-- [/DEF:DashboardHub] -->
+<!-- [/DEF:DashboardHub:Component] -->
 ```
 
 ---
@@ -374,7 +374,7 @@ export const activityStore = derived(
   let searchQuery = '';
   let environmentId = null;
 </script>
-<!-- [/DEF:DatasetHub] -->
+<!-- [/DEF:DatasetHub:Component] -->
 ```
 
 ---
@@ -406,7 +406,7 @@ export const activityStore = derived(
   export let items = []; // [{ label: string, path: string | null }]
   export let maxVisible = 3;
 </script>
-<!-- [/DEF:Breadcrumbs] -->
+<!-- [/DEF:Breadcrumbs:Component] -->
 ```
 
 ---
@@ -445,7 +445,7 @@ export const activityStore = derived(
 # Endpoint: POST /api/dashboards/backup
 # Body: { env_id, dashboard_ids, schedule (optional cron) }
 # Response: { task_id }
-# [/DEF:DashboardsAPI]
+# [/DEF:DashboardsAPI:Module]
 ```
 
 ---
@@ -482,7 +482,7 @@ export const activityStore = derived(
 # Endpoint: POST /api/datasets/generate-docs
 # Body: { env_id, dataset_ids, llm_provider, options }
 # Response: { task_id }
-# [/DEF:DatasetsAPI]
+# [/DEF:DatasetsAPI:Module]
 ```
 
 ---
@@ -506,7 +506,7 @@ export const activityStore = derived(
 
 # Endpoint: GET /api/activity
 # Response: { active_count: number, recent_tasks: [...] }
-# [/DEF:ActivityAPI]
+# [/DEF:ActivityAPI:Module]
 ```
 
 ---
@@ -535,7 +535,7 @@ class ResourceService:
     async def fetch_datasets(env_id: str, search: str = None) -> list[Dataset]: ...
     async def get_git_status(env_id: str, resource_id: str) -> GitStatus: ...
     async def get_last_task(resource_type: str, resource_id: str) -> TaskSummary: ...
-# [/DEF:ResourceService]
+# [/DEF:ResourceService:Class]
 ```
 
 ---
diff --git a/specs/020-task-reports-design/contracts/modules.md b/specs/020-task-reports-design/contracts/modules.md
index a597ae9f..9b039d49 100644
--- a/specs/020-task-reports-design/contracts/modules.md
+++ b/specs/020-task-reports-design/contracts/modules.md
@@ -15,7 +15,7 @@
 # @POST: Response contains normalized reports with deterministic ordering and total metadata.
 # @POST: Unknown task type is mapped to fallback type "unknown" and remains visible.
 # @POST: Partial payloads are rendered with placeholders, never causing report omission.
-# [/DEF:ReportsAggregationModule]
+# [/DEF:ReportsAggregationModule:Module]
 
 ---
 
@@ -33,7 +33,7 @@
 # @POST: List endpoint returns {items, total, page, page_size, has_next, applied_filters}.
 # @POST: Detail endpoint returns a single normalized report with diagnostics/next actions when available.
 # @POST: Validation errors are explicit (400-range) and machine-readable.
-# [/DEF:ReportsApiContract]
+# [/DEF:ReportsApiContract:Module]
 
 ---
 
@@ -59,7 +59,7 @@
  * @UX_FEEDBACK: On filter apply, list updates with immediate visual acknowledgment.
  * @UX_RECOVERY: Retry failed loads, clear filters, and continue reading partial reports with placeholders.
  */
-<!-- [/DEF:UnifiedReportsPage] -->
+<!-- [/DEF:UnifiedReportsPage:Component] -->
 
 ---
 
@@ -75,7 +75,7 @@
 # @INVARIANT: Native fetch is not used directly; existing wrapper-based request path is preserved.
 # @PRE: Valid auth token is present when required by backend.
 # @POST: Returns parsed report payload or structured error object for UI-state mapping.
-# [/DEF:ReportsApiClient]
+# [/DEF:ReportsApiClient:Module]
 
 ---
 
@@ -90,7 +90,7 @@
 # @INVARIANT: Exactly one fallback profile exists and is used for unknown task types.
 # @PRE: Input task_type may be known or unknown.
 # @POST: Returns profile with display label and variant tokens required for rendering.
-# [/DEF:ReportTypeProfileRegistry]
+# [/DEF:ReportTypeProfileRegistry:Module]
 
 ---
 
@@ -106,4 +106,4 @@ Scenario traced: Operator finds failed migration quickly and triages.
 6. `ReportsApiContract` detail endpoint returns diagnostics + `next_actions`.
 7. UI shows actionable failure context and recovery guidance without changing page context.
 
-Continuity check: No interface mismatch found across contracts for list/filter/detail path.
\ No newline at end of file
+Continuity check: No interface mismatch found across contracts for list/filter/detail path.
diff --git a/specs/021-llm-project-assistant/contracts/modules.md b/specs/021-llm-project-assistant/contracts/modules.md
index 2d2a652f..2a3bb22d 100644
--- a/specs/021-llm-project-assistant/contracts/modules.md
+++ b/specs/021-llm-project-assistant/contracts/modules.md
@@ -15,7 +15,7 @@
 # @PRE: Authenticated user context and non-empty user message are provided.
 # @POST: Returns one of deterministic states: needs_clarification, denied, needs_confirmation, started, success, failed.
 # @POST: Long-running operation responses include task_id when task is created.
-# [/DEF:AssistantOrchestratorModule]
+# [/DEF:AssistantOrchestratorModule:Module]
 
 ---
 
@@ -30,7 +30,7 @@
 # @INVARIANT: Parsed intent always includes confidence score and risk_level.
 # @PRE: Input text is available and sanitized.
 # @POST: Returns normalized intent or unknown intent with low confidence.
-# [/DEF:AssistantIntentParserModule]
+# [/DEF:AssistantIntentParserModule:Module]
 
 ---
 
@@ -46,7 +46,7 @@
 # @INVARIANT: Dangerous operations never execute without explicit confirmation token.
 # @PRE: Normalized intent and authenticated user context are available.
 # @POST: Returns one of {denied, needs_confirmation, allowed}.
-# [/DEF:AssistantSecurityGuardModule]
+# [/DEF:AssistantSecurityGuardModule:Module]
 
 ---
 
@@ -65,7 +65,7 @@
 # @INVARIANT: Adapter reuses existing execution paths and does not duplicate domain logic.
 # @PRE: ExecutionRequest is validated and authorized.
 # @POST: Returns operation result or started task_id for async flows.
-# [/DEF:AssistantExecutionAdapterModule]
+# [/DEF:AssistantExecutionAdapterModule:Module]
 
 ---
 
@@ -80,7 +80,7 @@
 # @INVARIANT: Every processed command emits one audit record.
 # @PRE: Command processing context is available.
 # @POST: Structured audit entry persisted with decision/outcome/task_id (if present).
-# [/DEF:AssistantAuditLogModule]
+# [/DEF:AssistantAuditLogModule:Module]
 
 ---
 
@@ -97,7 +97,7 @@
 # @POST: Message endpoint returns assistant response state + metadata.
 # @POST: Confirm endpoint executes pending dangerous command exactly once.
 # @POST: Cancel endpoint prevents execution of pending dangerous command.
-# [/DEF:AssistantApiContract]
+# [/DEF:AssistantApiContract:Module]
 
 ---
 
@@ -110,7 +110,7 @@
  * @PURPOSE: Render in-app assistant conversation and operational command interactions.
  * @LAYER: UI
  * @RELATION: DEPENDS_ON -> [DEF:AssistantApiClient]
- * @RELATION: USES -> [DEF:TaskDrawerStore]
+ * @RELATION: BINDS_TO -> [DEF:TaskDrawerStore:Store]
  * @INVARIANT: Every assistant response is rendered with explicit state badge.
  * @PRE: User is authenticated and assistant panel is accessible.
  * @POST: User can send command, receive response, and confirm/cancel risky operations.
@@ -121,7 +121,7 @@
  * @UX_STATE: Error -> Error card with retry/rephrase guidance displayed.
  * @UX_RECOVERY: User can rephrase ambiguous command or retry after error.
  */
-<!-- [/DEF:AssistantChatPanel] -->
+<!-- [/DEF:AssistantChatPanel:Component] -->
 
 ---
 
@@ -136,7 +136,7 @@
 # @INVARIANT: No direct native fetch bypassing project API wrapper conventions.
 # @PRE: Valid auth context/token exists.
 # @POST: Returns typed assistant response payload or structured error object.
-# [/DEF:AssistantApiClient]
+# [/DEF:AssistantApiClient:Module]
 
 ---
 
diff --git a/specs/023-clean-repo-enterprise/checklists/release-readiness.md b/specs/023-clean-repo-enterprise/checklists/release-readiness.md
index 16718441..7a2ad45d 100644
--- a/specs/023-clean-repo-enterprise/checklists/release-readiness.md
+++ b/specs/023-clean-repo-enterprise/checklists/release-readiness.md
@@ -1,10 +1,10 @@
-[DEF:specs.023-clean-repo-enterprise.checklists.release-readiness:Module]
-@TIER: STANDARD
-@SEMANTICS: release-readiness, compliance, evidence, enterprise-clean
-@PURPOSE: Checklist template for packaging compliance evidence before release publication.
-@LAYER: Domain
-@RELATION: BINDS_TO -> specs/023-clean-repo-enterprise/quickstart.md
-@INVARIANT: Release is publishable only when compliance status is COMPLIANT.
+# [DEF:specs.023-clean-repo-enterprise.checklists.release-readiness:Module]
+# @TIER: STANDARD
+# @SEMANTICS: release-readiness, compliance, evidence, enterprise-clean
+# @PURPOSE: Checklist template for packaging compliance evidence before release publication.
+# @LAYER: Domain
+# @RELATION: BINDS_TO -> specs/023-clean-repo-enterprise/quickstart.md
+# @INVARIANT: Release is publishable only when compliance status is COMPLIANT.
 
 # Release Readiness Checklist: Enterprise Clean Compliance
 
@@ -42,4 +42,4 @@
 - [ ] Ответственный за выпуск подтвердил допуск кандидата к публикации
 - [ ] Артефакт чеклиста сохранён вместе с релизной документацией
 
-[/DEF:specs.023-clean-repo-enterprise.checklists.release-readiness:Module]
\ No newline at end of file
+# [/DEF:specs.023-clean-repo-enterprise.checklists.release-readiness:Module]
diff --git a/specs/023-clean-repo-enterprise/contracts/modules.md b/specs/023-clean-repo-enterprise/contracts/modules.md
index c63707a3..4f7ef2a2 100644
--- a/specs/023-clean-repo-enterprise/contracts/modules.md
+++ b/specs/023-clean-repo-enterprise/contracts/modules.md
@@ -183,9 +183,9 @@ module CleanReleaseRouter:
 # @SEMANTICS: clean-release, config, yaml, policy-source, declarative
 # @PURPOSE: Load and validate .clean-release.yaml from repository root, providing typed config to all pipeline stages.
 # @LAYER: Infrastructure
-# @RELATION: CONSUMED_BY -> backend.src.services.clean_release.policy_engine
-# @RELATION: CONSUMED_BY -> backend.src.services.clean_release.compliance_orchestrator
 # @INVARIANT: Config load must fail fast on invalid/missing required fields for enterprise-clean profile.
+# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.policy_engine
+# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.compliance_orchestrator
 # @TEST_CONTRACT: YamlFilePath -> CleanReleaseConfig
 # @TEST_FIXTURE: valid_enterprise_config -> {"profile":"enterprise-clean","scan_mode":"repo","prohibited_categories":["test-data"],"allowed_sources":["*.corp.local"]}
 # @TEST_EDGE: missing_yaml -> repo without .clean-release.yaml must raise ConfigNotFoundError
@@ -212,8 +212,8 @@ class CleanReleaseConfigLoader:
 # @PURPOSE: Scan filesystem (repo/build/docker) for prohibited artifacts and external URLs in text files.
 # @LAYER: Domain
 # @RELATION: DEPENDS_ON -> backend.src.services.clean_release.config_loader
-# @RELATION: CONSUMED_BY -> backend.src.services.clean_release.compliance_orchestrator
 # @INVARIANT: Scanner must respect ignore_paths and never modify scanned files.
+# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.compliance_orchestrator
 # @TEST_CONTRACT: ScanTarget + CleanReleaseConfig -> ScanResult
 # @TEST_FIXTURE: repo_with_test_data -> {"path":"test/data.csv","category":"test-data","classification":"excluded-prohibited"}
 # @TEST_EDGE: binary_file_skip -> binary files must be skipped during URL extraction
@@ -240,8 +240,8 @@ class FilesystemScanner:
 # @PURPOSE: Execute database cleanup rules from .clean-release.yaml to remove test users and demo data.
 # @LAYER: Domain
 # @RELATION: DEPENDS_ON -> backend.src.services.clean_release.config_loader
-# @RELATION: CONSUMED_BY -> backend.src.services.clean_release.compliance_orchestrator
 # @INVARIANT: Preserve-listed records must never be deleted regardless of condition match.
+# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.compliance_orchestrator
 # @TEST_CONTRACT: DatabaseCleanupConfig -> CleanupResult
 # @TEST_FIXTURE: cleanup_test_users -> {"table":"ab_user","condition":"username IN ('test_user')","preserve":["admin"]}
 # @TEST_EDGE: preserve_overrides_condition -> preserved record matching condition must survive cleanup
@@ -271,4 +271,4 @@ class DatabaseCleanupExecutor:
 3. [`policy_engine`](#defbackendsrcservicesclean_releasepolicy_enginemodule) обнаруживает `external-source` нарушение и возвращает fail stage + violation.  
 4. [`compliance_orchestrator`](#defbackendsrcservicesclean_releasecompliance_orchestratormodule) завершает run статусом BLOCKED.  
 5. [`report_builder`](#defbackendsrcservicesclean_releasereport_buildermodule) формирует отчёт с remediation.  
-6. [`clean_release_tui`](#defbackendsrcscriptsclean_release_tuimodule) отображает BLOCKED + таблицу нарушений + путь восстановления.
\ No newline at end of file
+6. [`clean_release_tui`](#defbackendsrcscriptsclean_release_tuimodule) отображает BLOCKED + таблицу нарушений + путь восстановления.
diff --git a/specs/023-clean-repo-enterprise/plan.md b/specs/023-clean-repo-enterprise/plan.md
index 0dbf5455..78136274 100644
--- a/specs/023-clean-repo-enterprise/plan.md
+++ b/specs/023-clean-repo-enterprise/plan.md
@@ -164,7 +164,7 @@ frontend/
 
 **Gate Result (post-design)**: PASS
 
-**Operational Note (resolved)**: конфликт numeric prefix `020` устранён governance-решением: enterprise clean feature закреплён под уникальным префиксом `023` (ветка и feature-directory: `023-clean-repo-enterprise`). Проверка prereqs и speckit-поток выполняются с `FEATURE_DIR=specs/023-clean-repo-enterprise` без неоднозначности с [`specs/020-task-reports-design`](../020-task-reports-design).
+**Operational Note (resolved)**: конфликт numeric prefix `020` устранён governance-решением: enterprise clean feature закреплён под уникальным префиксом `023` (ветка и feature-directory: `023-clean-repo-enterprise`). Проверка prereqs и speckit-поток выполняются с `FEATURE_DIR=specs/023-clean-repo-enterprise` без неоднозначности с [`specs/020-task-reports-design`](../020-task-reports-design) и тестовым маршрутом [`backend/src/api/routes/__tests__/test_clean_release_api.py`](../../backend/src/api/routes/__tests__/test_clean_release_api.py).
 
 ## Implementation Traceability & Final Notes
 
@@ -172,7 +172,7 @@ frontend/
 - Новое расширение (post-release hardening, 2026-03-13): добавлен scope на управляемый bootstrap администратора через `.env.enterprise-clean` и docker startup flow.
 - Ключевые подтверждения polish-фазы:
   - T039: smoke TUI сценария зафиксирован в [`quickstart.md`](./quickstart.md).
-  - T040: контрактная проверка API подтверждена тестом [`backend/tests/api/routes/test_clean_release_api.py`](../../backend/tests/api/routes/test_clean_release_api.py).
+  - T040: контрактная проверка API подтверждена тестом [`backend/src/api/routes/__tests__/test_clean_release_api.py`](../../backend/src/api/routes/__tests__/test_clean_release_api.py).
   - T041: создан чеклист evidence package [`checklists/release-readiness.md`](./checklists/release-readiness.md).
   - T042: governance conflict по префиксу закрыт и задокументирован.
   - T043: добавлена итоговая traceability-нотация в текущем плане.
diff --git a/specs/023-clean-repo-enterprise/quickstart.md b/specs/023-clean-repo-enterprise/quickstart.md
index 526f9ebb..a24fbec6 100644
--- a/specs/023-clean-repo-enterprise/quickstart.md
+++ b/specs/023-clean-repo-enterprise/quickstart.md
@@ -142,8 +142,8 @@ cd /home/busya/dev/ss-tools
   - `cd backend && .venv/bin/python3 -m src.scripts.clean_release_tui`
   - Результат: `PASS` (exit code 0, состояние `READY`, панель внутренних источников отображается).
 - API contract smoke command:
-  - `cd backend && .venv/bin/python3 -m pytest tests/api/routes/test_clean_release_api.py -q`
+  - `cd backend && .venv/bin/python3 -m pytest src/api/routes/__tests__/test_clean_release_api.py -q`
   - Результат: `PASS` (`2 passed`), shape контрактов `/api/clean-release/checks*` и `/api/clean-release/reports/{id}` подтверждён.
 
 Примечание:
-- В тестовом прогоне есть существующие проектные предупреждения (Pydantic/FastAPI deprecations), но блокирующих ошибок для feature smoke-проверки не обнаружено.
\ No newline at end of file
+- В тестовом прогоне есть существующие проектные предупреждения (Pydantic/FastAPI deprecations), но блокирующих ошибок для feature smoke-проверки не обнаружено.
diff --git a/specs/023-clean-repo-enterprise/tasks.md b/specs/023-clean-repo-enterprise/tasks.md
index 906fc149..e9619d69 100644
--- a/specs/023-clean-repo-enterprise/tasks.md
+++ b/specs/023-clean-repo-enterprise/tasks.md
@@ -96,7 +96,7 @@
 
 - [X] T026 [P] [US3] Add orchestrator state machine tests for stage pass/fail transitions in `backend/tests/services/clean_release/test_compliance_orchestrator.py`
 - [X] T027 [P] [US3] Add report builder validation tests for counters and blocking violations in `backend/tests/services/clean_release/test_report_builder.py`
-- [X] T028 [P] [US3] Add API contract tests for `/api/clean-release/checks*` and `/api/clean-release/reports/{id}` in `backend/tests/api/routes/test_clean_release_api.py`
+- [X] T028 [P] [US3] Add API contract tests for `/api/clean-release/checks*` and `/api/clean-release/reports/{id}` in `backend/src/api/routes/__tests__/test_clean_release_api.py`
 
 ### Implementation for User Story 3
 
@@ -133,7 +133,7 @@
 **Purpose**: Финализация, smoke-проверки и governance-замыкание.
 
 - [X] T039 [P] Run end-to-end smoke validation of TUI scenario from `quickstart.md` and record results in `specs/023-clean-repo-enterprise/quickstart.md`
-- [X] T040 [P] Validate OpenAPI contract consistency against implemented routes in `backend/tests/api/routes/test_clean_release_api.py`
+- [X] T040 [P] Validate OpenAPI contract consistency against implemented routes in `backend/src/api/routes/__tests__/test_clean_release_api.py`
 - [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] T043 Update feature status traceability and final notes in `specs/023-clean-repo-enterprise/plan.md`
@@ -220,4 +220,4 @@ Task: "T024 [US2] Update TUI view model for Allowed Internal Sources and blockin
 
 - Tasks explicitly preserve TUI/ncurses interaction model from [`ux_reference.md`](./ux_reference.md).
 - No task introduces web UI replacement for the primary operator flow.
-- Each user story phase contains a mandatory UX conformance verification task.
\ No newline at end of file
+- Each user story phase contains a mandatory UX conformance verification task.
diff --git a/specs/023-clean-repo-enterprise/tests/README.md b/specs/023-clean-repo-enterprise/tests/README.md
index b8219431..5ff20c41 100644
--- a/specs/023-clean-repo-enterprise/tests/README.md
+++ b/specs/023-clean-repo-enterprise/tests/README.md
@@ -1,3 +1,8 @@
+# [DEF:specs.023-clean-repo-enterprise.tests.README:Module]
+# @COMPLEXITY: 1
+# @PURPOSE: Test Strategy and coverage matrices for Clean Repository Enterprise Profile.
+# [/DEF:specs.023-clean-repo-enterprise.tests.README:Module]
+
 # Test Strategy: Clean Repository Enterprise Profile
 
 ## Overview
@@ -17,5 +22,5 @@ This directory contains strategy, coverage matrices, and execution reports for t
 ## Execution
 Run testing via Pytest targeting backend test modules:
 ```bash
-cd backend && .venv/bin/python3 -m pytest tests/services/clean_release tests/api/routes/test_clean_release_api.py tests/api/routes/test_clean_release_source_policy.py -v
+cd backend && .venv/bin/python3 -m pytest tests/services/clean_release src/api/routes/__tests__/test_clean_release_api.py src/api/routes/__tests__/test_clean_release_source_policy.py -v
 ```
diff --git a/specs/024-user-dashboard-filter/contracts/modules.md b/specs/024-user-dashboard-filter/contracts/modules.md
index c0d97adc..6569633a 100644
--- a/specs/024-user-dashboard-filter/contracts/modules.md
+++ b/specs/024-user-dashboard-filter/contracts/modules.md
@@ -149,29 +149,27 @@ module DashboardProfileFilterExtension:
 ---
 
 <!-- [DEF:frontend.src.routes.profile.+page:Module] -->
-<!--
-@TIER: CRITICAL
-@SEMANTICS: profile-page, preferences, lookup, save, ux-states
-@PURPOSE: Provide profile UI for binding Superset account and saving default "my dashboards" preference.
-@LAYER: UI
-@RELATION: BINDS_TO -> frontend.src.lib.api
-@RELATION: BINDS_TO -> frontend.src.lib.i18n
-@INVARIANT: Save action never updates another user's preference.
-@UX_STATE: Default -> Current preference shown with environment selector, account input, and toggle.
-@UX_STATE: LookupLoading -> Account candidate list shows loading indicator for selected environment.
-@UX_STATE: LookupError -> Inline warning shown; manual username entry remains enabled.
-@UX_STATE: Saving -> Save button disabled and shows progress.
-@UX_STATE: SaveSuccess -> Success toast appears and form reflects persisted values.
-@UX_STATE: SaveError -> Error feedback shown without losing user input.
-@UX_FEEDBACK: Toasts for save result, inline validation and lookup fallback messaging.
-@UX_RECOVERY: User can retry lookup, manually enter username, or disable toggle to continue.
-@TEST_CONTRACT: ProfilePageInteraction -> PreferencePersisted
-@TEST_FIXTURE: bind_account_happy_path -> {"env_id":"dev","candidate":"j.doe","toggle":true}
-@TEST_EDGE: lookup_failed_manual_fallback -> save still possible with manually entered username
-@TEST_EDGE: invalid_username -> save blocked with inline validation error
-@TEST_EDGE: cancel_changes -> persisted state remains unchanged
-@TEST_INVARIANT: lookup_does_not_block_manual_save -> VERIFIED_BY: [lookup_failed_manual_fallback, bind_account_happy_path]
--->
+<!-- @TIER: CRITICAL -->
+<!-- @SEMANTICS: profile-page, preferences, lookup, save, ux-states -->
+<!-- @PURPOSE: Provide profile UI for binding Superset account and saving default "my dashboards" preference. -->
+<!-- @LAYER: UI -->
+<!-- @RELATION: BINDS_TO -> frontend.src.lib.api -->
+<!-- @RELATION: BINDS_TO -> frontend.src.lib.i18n -->
+<!-- @INVARIANT: Save action never updates another user's preference. -->
+<!-- @UX_STATE: Default -> Current preference shown with environment selector, account input, and toggle. -->
+<!-- @UX_STATE: LookupLoading -> Account candidate list shows loading indicator for selected environment. -->
+<!-- @UX_STATE: LookupError -> Inline warning shown; manual username entry remains enabled. -->
+<!-- @UX_STATE: Saving -> Save button disabled and shows progress. -->
+<!-- @UX_STATE: SaveSuccess -> Success toast appears and form reflects persisted values. -->
+<!-- @UX_STATE: SaveError -> Error feedback shown without losing user input. -->
+<!-- @UX_FEEDBACK: Toasts for save result, inline validation and lookup fallback messaging. -->
+<!-- @UX_RECOVERY: User can retry lookup, manually enter username, or disable toggle to continue. -->
+<!-- @TEST_CONTRACT: ProfilePageInteraction -> PreferencePersisted -->
+<!-- @TEST_FIXTURE: bind_account_happy_path -> {"env_id":"dev","candidate":"j.doe","toggle":true} -->
+<!-- @TEST_EDGE: lookup_failed_manual_fallback -> save still possible with manually entered username -->
+<!-- @TEST_EDGE: invalid_username -> save blocked with inline validation error -->
+<!-- @TEST_EDGE: cancel_changes -> persisted state remains unchanged -->
+<!-- @TEST_INVARIANT: lookup_does_not_block_manual_save -> VERIFIED_BY: [lookup_failed_manual_fallback, bind_account_happy_path] -->
 module ProfilePage:
   /** @PURPOSE Render profile preference form and orchestrate lookup/save flows. */
   function renderAndHandleState() {}
@@ -180,26 +178,24 @@ module ProfilePage:
 ---
 
 <!-- [DEF:frontend.src.routes.dashboards.+page.profile_filter_ui_extension:Module] -->
-<!--
-@TIER: CRITICAL
-@SEMANTICS: dashboards-page, profile-filter-indicator, override, empty-state
-@PURPOSE: Apply profile-default filter context on main dashboards page and provide temporary "show all" override.
-@LAYER: UI
-@RELATION: BINDS_TO -> frontend.src.lib.api
-@RELATION: BINDS_TO -> frontend.src.routes.profile.+page
-@INVARIANT: Temporary override never mutates saved profile preference.
-@UX_STATE: FilterActive -> Visible badge "My Dashboards Only" with clear action.
-@UX_STATE: OverrideActive -> Full list shown with hint that preference remains saved.
-@UX_STATE: EmptyFiltered -> Friendly no-match message with path to profile adjustment.
-@UX_FEEDBACK: Immediate list refresh after profile save and after override toggle.
-@UX_RECOVERY: User can clear override or edit profile binding and reload list.
-@TEST_CONTRACT: DashboardsFilterUiAction -> DashboardsGridState
-@TEST_FIXTURE: default_profile_filter_applied -> {"saved_toggle":true,"username":"j.doe"}
-@TEST_EDGE: no_matching_dashboards -> EmptyFiltered state rendered
-@TEST_EDGE: temporary_show_all -> list restored while saved preference preserved
-@TEST_EDGE: return_to_page -> FilterActive restored from saved preference
-@TEST_INVARIANT: override_non_persistent -> VERIFIED_BY: [temporary_show_all, return_to_page]
--->
+<!-- @TIER: CRITICAL -->
+<!-- @SEMANTICS: dashboards-page, profile-filter-indicator, override, empty-state -->
+<!-- @PURPOSE: Apply profile-default filter context on main dashboards page and provide temporary "show all" override. -->
+<!-- @LAYER: UI -->
+<!-- @RELATION: BINDS_TO -> frontend.src.lib.api -->
+<!-- @RELATION: BINDS_TO -> frontend.src.routes.profile.+page -->
+<!-- @INVARIANT: Temporary override never mutates saved profile preference. -->
+<!-- @UX_STATE: FilterActive -> Visible badge "My Dashboards Only" with clear action. -->
+<!-- @UX_STATE: OverrideActive -> Full list shown with hint that preference remains saved. -->
+<!-- @UX_STATE: EmptyFiltered -> Friendly no-match message with path to profile adjustment. -->
+<!-- @UX_FEEDBACK: Immediate list refresh after profile save and after override toggle. -->
+<!-- @UX_RECOVERY: User can clear override or edit profile binding and reload list. -->
+<!-- @TEST_CONTRACT: DashboardsFilterUiAction -> DashboardsGridState -->
+<!-- @TEST_FIXTURE: default_profile_filter_applied -> {"saved_toggle":true,"username":"j.doe"} -->
+<!-- @TEST_EDGE: no_matching_dashboards -> EmptyFiltered state rendered -->
+<!-- @TEST_EDGE: temporary_show_all -> list restored while saved preference preserved -->
+<!-- @TEST_EDGE: return_to_page -> FilterActive restored from saved preference -->
+<!-- @TEST_INVARIANT: override_non_persistent -> VERIFIED_BY: [temporary_show_all, return_to_page] -->
 module DashboardsProfileFilterUI:
   /** @PURPOSE Render active-filter indicator and manage temporary override state. */
   function renderFilterIndicatorAndOverride() {}
@@ -211,12 +207,12 @@ module DashboardsProfileFilterUI:
 
 Scenario: User binds Superset account from environment and sees filtered dashboards by default.
 
-1. [`frontend.src.routes.profile.+page`](#deffrontendsrcroutesprofilepagemodule) requests account candidates for selected environment.
-2. [`backend.src.api.routes.profile`](#defbackendsrcapiroutesprofilemodule) validates self-scope and forwards lookup request.
-3. [`backend.src.services.profile_service`](#defbackendsrcservicesprofile_servicemodule) orchestrates lookup via [`backend.src.core.superset_profile_lookup`](#defbackendsrccoresuperset_profile_lookupmodule).
-4. User saves preference; profile service normalizes username and persists [`backend.src.models.profile`](#defbackendsrcmodelsprofilemodule).
-5. On `/dashboards`, [`backend.src.api.routes.dashboards.profile_filter_extension`](#defbackendsrcapiroutesdashboardsprofile_filter_extensionmodule) applies `owners OR modified_by` matching and returns effective filter metadata.
-6. [`frontend.src.routes.dashboards.+page.profile_filter_ui_extension`](#deffrontendsrcroutesdashboardspageprofile_filter_ui_extensionmodule) shows active badge and supports temporary "show all" override.
+1. `frontend.src.routes.profile.+page` requests account candidates for the selected environment.
+2. `backend.src.api.routes.profile` validates self-scope and forwards the lookup request.
+3. `backend.src.services.profile_service` orchestrates lookup via `backend.src.core.superset_profile_lookup`.
+4. User saves preference; the profile service normalizes the username and persists `backend.src.models.profile`.
+5. On `/dashboards`, `backend.src.api.routes.dashboards.profile_filter_extension` applies `owners OR modified_by` matching and returns effective filter metadata.
+6. `frontend.src.routes.dashboards.+page.profile_filter_ui_extension` shows the active badge and supports temporary "show all" override.
 
 ---
 
@@ -230,4 +226,4 @@ Scenario: User binds Superset account from environment and sees filtered dashboa
 | `owners OR modified_by` normalization contract | `backend/src/api/routes/__tests__/test_dashboards.py::test_get_dashboards_profile_filter_contract_owners_or_modified_by` | ✅ |
 | `override_show_all` semantics | `backend/src/api/routes/__tests__/test_dashboards.py::test_get_dashboards_override_show_all_contract` | ✅ |
 | `no_match_results` under active profile filter | `backend/src/api/routes/__tests__/test_dashboards.py::test_get_dashboards_profile_filter_no_match_results_contract` | ✅ |
-| page-scoped override restore UX | `frontend/src/routes/dashboards/__tests__/dashboard-profile-override.integration.test.js` | ✅ |
\ No newline at end of file
+| page-scoped override restore UX | `frontend/src/routes/dashboards/__tests__/dashboard-profile-override.integration.test.js` | ✅ |
diff --git a/specs/025-clean-release-compliance/contracts/modules.md b/specs/025-clean-release-compliance/contracts/modules.md
index 6c6810de..9bc95e07 100644
--- a/specs/025-clean-release-compliance/contracts/modules.md
+++ b/specs/025-clean-release-compliance/contracts/modules.md
@@ -17,7 +17,7 @@
 # @TEST_EDGE: publish_without_approval -> reject transition
 # @TEST_EDGE: mutate_existing_manifest -> reject update
 # @TEST_INVARIANT: lifecycle_integrity -> VERIFIED_BY: [approve_without_passed_report, publish_without_approval, mutate_existing_manifest]
-# [/DEF:CleanReleaseDomainModule]
+# [/DEF:CleanReleaseDomainModule:Module]
 
 ---
 
@@ -43,7 +43,7 @@
 # @TEST_EDGE: illegal_transition -> returns transition error
 # @TEST_EDGE: missing_policy_snapshot -> returns trusted-source error
 # @TEST_INVARIANT: thin_client_boundary -> VERIFIED_BY: [missing_candidate, illegal_transition, missing_policy_snapshot]
-# [/DEF:CleanReleaseFacadeModule]
+# [/DEF:CleanReleaseFacadeModule:Module]
 
 ---
 
@@ -66,7 +66,7 @@
 # @TEST_EDGE: malformed_artifact_payload -> reject import
 # @TEST_EDGE: empty_artifact_set -> reject mark_prepared
 # @TEST_INVARIANT: candidate_input_integrity -> VERIFIED_BY: [duplicate_candidate_id, malformed_artifact_payload, empty_artifact_set]
-# [/DEF:CandidatePreparationServiceModule]
+# [/DEF:CandidatePreparationServiceModule:Module]
 
 ---
 
@@ -89,7 +89,7 @@
 # @TEST_EDGE: build_with_changed_artifacts -> create new version
 # @TEST_EDGE: overwrite_existing_manifest -> reject mutation
 # @TEST_INVARIANT: manifest_snapshot_integrity -> VERIFIED_BY: [build_without_candidate, build_with_changed_artifacts, overwrite_existing_manifest]
-# [/DEF:ManifestServiceModule]
+# [/DEF:ManifestServiceModule:Module]
 
 ---
 
@@ -111,7 +111,7 @@
 # @TEST_EDGE: registry_missing -> reject request
 # @TEST_EDGE: ui_override_attempt -> ignore override and fail validation
 # @TEST_INVARIANT: trusted_input_boundary -> VERIFIED_BY: [missing_profile, registry_missing, ui_override_attempt]
-# [/DEF:PolicyResolutionServiceModule]
+# [/DEF:PolicyResolutionServiceModule:Module]
 
 ---
 
@@ -138,7 +138,7 @@
 # @TEST_EDGE: task_crash_mid_run -> final_status ERROR with preserved partial evidence
 # @TEST_EDGE: blocked_violation_without_report -> reject finalization
 # @TEST_INVARIANT: run_report_consistency -> VERIFIED_BY: [run_without_manifest, task_crash_mid_run, blocked_violation_without_report]
-# [/DEF:ComplianceExecutionServiceModule]
+# [/DEF:ComplianceExecutionServiceModule:Module]
 
 ---
 
@@ -153,7 +153,7 @@
 # @INVARIANT: Mandatory stages execute in stable order unless run stops on terminal error policy.
 # @PRE: Compliance context contains candidate, manifest, policy snapshot and registry snapshot.
 # @POST: Each stage returns decision, violations and details without mutating trusted snapshots.
-# [/DEF:StagePipelineModule]
+# [/DEF:StagePipelineModule:Module]
 
 ---
 
@@ -177,7 +177,7 @@
 # @TEST_EDGE: duplicate_approve_terminal_state -> reject or preserve existing state deterministically
 # @TEST_EDGE: reject_then_publish -> publish remains blocked until a later valid approve
 # @TEST_INVARIANT: approval_gate_integrity -> VERIFIED_BY: [approve_blocked_report, approve_foreign_report, duplicate_approve_terminal_state, reject_then_publish]
-# [/DEF:ApprovalServiceModule]
+# [/DEF:ApprovalServiceModule:Module]
 
 ---
 
@@ -200,7 +200,7 @@
 # @TEST_EDGE: revoke_unknown_publication -> reject request
 # @TEST_EDGE: republish_after_revoke -> deterministic policy required
 # @TEST_INVARIANT: publication_gate_integrity -> VERIFIED_BY: [publish_without_approval, revoke_unknown_publication, republish_after_revoke]
-# [/DEF:PublicationServiceModule]
+# [/DEF:PublicationServiceModule:Module]
 
 ---
 
@@ -219,7 +219,7 @@
 # @INVARIANT: Audit records are append-only in real mode.
 # @PRE: Event context contains actor and operation identifiers.
 # @POST: One structured audit event is persisted per critical lifecycle mutation.
-# [/DEF:AuditServiceModule]
+# [/DEF:AuditServiceModule:Module]
 
 ---
 
@@ -231,7 +231,7 @@
 # @PURPOSE: Persist and query release candidates and candidate overview projections.
 # @LAYER: Infra
 # @INVARIANT: Candidate writes honor lifecycle guards defined in the domain module.
-# [/DEF:CandidateRepositoryModule]
+# [/DEF:CandidateRepositoryModule:Module]
 
 # [DEF:ArtifactRepositoryModule:Module]
 # @TIER: STANDARD
@@ -239,7 +239,7 @@
 # @PURPOSE: Persist and query candidate artifacts with checksum metadata.
 # @LAYER: Infra
 # @INVARIANT: Artifact checksum/path records remain stable after import.
-# [/DEF:ArtifactRepositoryModule]
+# [/DEF:ArtifactRepositoryModule:Module]
 
 # [DEF:ManifestRepositoryModule:Module]
 # @TIER: STANDARD
@@ -247,7 +247,7 @@
 # @PURPOSE: Persist immutable manifests and provide latest-version lookup.
 # @LAYER: Infra
 # @INVARIANT: Existing manifest versions are read-only.
-# [/DEF:ManifestRepositoryModule]
+# [/DEF:ManifestRepositoryModule:Module]
 
 # [DEF:PolicySnapshotRepositoryModule:Module]
 # @TIER: STANDARD
@@ -255,7 +255,7 @@
 # @PURPOSE: Persist immutable policy and registry snapshots used by runs.
 # @LAYER: Infra
 # @INVARIANT: Snapshot content cannot be mutated after persistence.
-# [/DEF:PolicySnapshotRepositoryModule]
+# [/DEF:PolicySnapshotRepositoryModule:Module]
 
 # [DEF:ComplianceRepositoryModule:Module]
 # @TIER: STANDARD
@@ -263,7 +263,7 @@
 # @PURPOSE: Persist compliance runs, stage records and violations.
 # @LAYER: Infra
 # @INVARIANT: Historical run evidence is append-only in real mode.
-# [/DEF:ComplianceRepositoryModule]
+# [/DEF:ComplianceRepositoryModule:Module]
 
 # [DEF:ReportRepositoryModule:Module]
 # @TIER: STANDARD
@@ -271,7 +271,7 @@
 # @PURPOSE: Persist immutable compliance reports and support report lookup by run and candidate.
 # @LAYER: Infra
 # @INVARIANT: Completed reports remain immutable.
-# [/DEF:ReportRepositoryModule]
+# [/DEF:ReportRepositoryModule:Module]
 
 # [DEF:ApprovalRepositoryModule:Module]
 # @TIER: STANDARD
@@ -279,7 +279,7 @@
 # @PURPOSE: Persist immutable approval decisions and query latest decision state.
 # @LAYER: Infra
 # @INVARIANT: Approval decisions are historical facts, not mutable flags.
-# [/DEF:ApprovalRepositoryModule]
+# [/DEF:ApprovalRepositoryModule:Module]
 
 # [DEF:PublicationRepositoryModule:Module]
 # @TIER: STANDARD
@@ -287,7 +287,7 @@
 # @PURPOSE: Persist publication and revocation records.
 # @LAYER: Infra
 # @INVARIANT: Publication history is append-only.
-# [/DEF:PublicationRepositoryModule]
+# [/DEF:PublicationRepositoryModule:Module]
 
 # [DEF:TrustedPolicyStoreModule:Module]
 # @TIER: STANDARD
@@ -295,7 +295,7 @@
 # @PURPOSE: Abstract the trusted read-only source of policies and source registries.
 # @LAYER: Infra
 # @INVARIANT: Store reads are side-effect free for clean release operations.
-# [/DEF:TrustedPolicyStoreModule]
+# [/DEF:TrustedPolicyStoreModule:Module]
 
 ---
 
@@ -319,7 +319,7 @@
 # @TEST_EDGE: invalid_input_http -> 422 validation error
 # @TEST_EDGE: reject_without_passed_report_http -> 409 conflict
 # @TEST_INVARIANT: api_contract_stability -> VERIFIED_BY: [invalid_transition_http, missing_candidate_http, invalid_input_http, reject_without_passed_report_http]
-# [/DEF:CleanReleaseApiContract]
+# [/DEF:CleanReleaseApiContract:Module]
 
 ---
 
@@ -340,7 +340,7 @@
 # @TEST_EDGE: cli_blocked_run -> exit code 1
 # @TEST_EDGE: cli_system_error -> exit code 3
 # @TEST_INVARIANT: cli_headless_integrity -> VERIFIED_BY: [cli_missing_manifest, cli_blocked_run, cli_system_error]
-# [/DEF:CleanReleaseCliContract]
+# [/DEF:CleanReleaseCliContract:Module]
 
 ---
 
@@ -370,7 +370,7 @@
  * @TEST_EDGE: blocked_report_on_F8 -> approve action disabled
  * @TEST_INVARIANT: tui_thin_client_boundary -> VERIFIED_BY: [no_tty_environment, missing_manifest_on_F5, blocked_report_on_F8]
  */
-<!-- [/DEF:CleanReleaseTuiApp] -->
+<!-- [/DEF:CleanReleaseTuiApp:Component] -->
 
 ---
 
diff --git a/specs/026-dashboard-health-windows/contracts/modules.md b/specs/026-dashboard-health-windows/contracts/modules.md
index 9a66c604..0e5d6a56 100644
--- a/specs/026-dashboard-health-windows/contracts/modules.md
+++ b/specs/026-dashboard-health-windows/contracts/modules.md
@@ -2,7 +2,7 @@
 
 ## Backend Contracts
 
-### [DEF:ValidationPolicyModel:Class]
+# [DEF:ValidationPolicyModel:Class]
 # @TIER: STANDARD
 # @SEMANTICS: SQLAlchemy, Model
 # @PURPOSE: Database model for storing validation scheduling rules.
@@ -10,17 +10,17 @@
 # @RELATION: DEPENDS_ON -> SQLAlchemy declarative base
 # @PRE: Policy payload contains valid window_start and window_end strings.
 # @POST: Policy is persisted with default `is_active=True`.
-[/DEF:ValidationPolicyModel]
+# [/DEF:ValidationPolicyModel:Class]
 
-### [DEF:ValidationPolicySchema:Class]
+# [DEF:ValidationPolicySchema:Class]
 # @TIER: TRIVIAL
 # @SEMANTICS: Pydantic, Schema
 # @PURPOSE: API contract for reading and writing Validation Policies.
 # @LAYER: API
 # @RELATION: DEPENDS_ON -> ValidationPolicyModel
-[/DEF:ValidationPolicySchema]
+# [/DEF:ValidationPolicySchema:Class]
 
-### [DEF:HealthService:Class]
+# [DEF:HealthService:Class]
 # @TIER: CRITICAL
 # @SEMANTICS: Service, Aggregation
 # @PURPOSE: Aggregates dashboard metadata with the latest ValidationRecord to produce health summaries.
@@ -34,9 +34,9 @@
 # @TEST_FIXTURE: test_health_aggregation_success -> mock_dashboards_and_records
 # @TEST_EDGE: test_health_aggregation_no_records -> Returns UNKNOWN status for dashboards without records.
 # @TEST_INVARIANT: latest_record_wins -> VERIFIED_BY: [test_health_aggregation_success]
-[/DEF:HealthService]
+# [/DEF:HealthService:Class]
 
-### [DEF:HealthRouter:Module]
+# [DEF:HealthRouter:Module]
 # @TIER: STANDARD
 # @SEMANTICS: FastAPI, Route
 # @PURPOSE: API endpoints for the Health Center UI.
@@ -44,9 +44,9 @@
 # @RELATION: CALLS -> HealthService
 # @PRE: Request includes valid authentication token.
 # @POST: Returns JSON list of dashboard health statuses.
-[/DEF:HealthRouter]
+# [/DEF:HealthRouter:Module]
 
-### [DEF:NotificationService:Class]
+# [DEF:NotificationService:Class]
 # @TIER: CRITICAL
 # @SEMANTICS: Service, PubSub
 # @PURPOSE: Evaluates policies and routes formatted notifications to dynamically resolved owners and explicit channels.
@@ -61,18 +61,18 @@
 # @TEST_FIXTURE: test_owner_routing -> mock_profile_with_telegram
 # @TEST_EDGE: test_missing_profile_contact -> Skips owner if no valid contact info is found without crashing.
 # @TEST_INVARIANT: async_dispatch -> VERIFIED_BY: [test_owner_routing]
-[/DEF:NotificationService]
+# [/DEF:NotificationService:Class]
 
-### [DEF:NotificationProvider:Interface]
+# [DEF:NotificationProvider:Class]
 # @TIER: STANDARD
 # @SEMANTICS: Interface, Strategy
 # @PURPOSE: Base abstraction for sending formatted alerts to external systems (SMTP, Slack, Telegram).
 # @LAYER: Infra
 # @PRE: Receives a standardized AlertPayload (text + image links).
 # @POST: Delivers the payload to the external system.
-[/DEF:NotificationProvider]
+# [/DEF:NotificationProvider:Class]
 
-### [DEF:ThrottledSchedulerConfigurator:Module]
+# [DEF:ThrottledSchedulerConfigurator:Module]
 # @TIER: CRITICAL
 # @SEMANTICS: Scheduler, APScheduler
 # @PURPOSE: Reads active ValidationPolicies and generates distributed cron/date triggers within the defined execution window.
@@ -86,11 +86,11 @@
 # @TEST_FIXTURE: test_window_distribution -> policy_1hr_60tasks
 # @TEST_EDGE: test_window_too_small -> 100 tasks in 1 min -> Falls back to minimum safe interval or logs warning.
 # @TEST_INVARIANT: distribution_bounds -> VERIFIED_BY: [test_window_distribution, test_window_too_small]
-[/DEF:ThrottledSchedulerConfigurator]
+# [/DEF:ThrottledSchedulerConfigurator:Module]
 
 ## Frontend Contracts
 
-### [DEF:HealthMatrix:Component]
+# [DEF:HealthMatrix:Component]
 # @TIER: STANDARD
 # @SEMANTICS: Svelte, UI
 # @PURPOSE: Displays traffic light summary cards (Pass, Warn, Fail).
@@ -100,9 +100,9 @@
 # @POST: Renders three numeric summary cards with distinct colors.
 # @UX_STATE: Loading -> Skeleton cards.
 # @UX_STATE: Idle -> Distinct colored counts.
-[/DEF:HealthMatrix]
+# [/DEF:HealthMatrix:Component]
 
-### [DEF:HealthCenterPage:Page]
+# [DEF:HealthCenterPage:Component]
 # @TIER: CRITICAL
 # @SEMANTICS: SvelteKit, Route
 # @PURPOSE: Main monitoring view for dashboard validation health.
@@ -115,9 +115,9 @@
 # @UX_STATE: Error -> Toast notification and empty state.
 # @UX_STATE: Success -> Matrix and populated table.
 # @UX_TEST: FilterClick -> {click: "Fail only", expected: table shows only RED rows}
-[/DEF:HealthCenterPage]
+# [/DEF:HealthCenterPage:Component]
 
-### [DEF:AutomationPoliciesPage:Page]
+# [DEF:AutomationPoliciesPage:Component]
 # @TIER: STANDARD
 # @SEMANTICS: SvelteKit, Route
 # @PURPOSE: Settings view to create and manage validation policies.
@@ -127,9 +127,9 @@
 # @POST: Renders list of policies and 'Create Rule' modal.
 # @UX_STATE: Creating -> Modal is open with form.
 # @UX_FEEDBACK: SaveSuccess -> Toast "Policy scheduled".
-[/DEF:AutomationPoliciesPage]
+# [/DEF:AutomationPoliciesPage:Component]
 
-### [DEF:SidebarHealthBadge:Store]
+# [DEF:SidebarHealthBadge:Store]
 # @TIER: STANDARD
 # @SEMANTICS: Svelte Store
 # @PURPOSE: Derived or fetched state to show `[🔴 N]` badge on the sidebar.
@@ -137,4 +137,4 @@
 # @RELATION: DEPENDS_ON -> ActivityStore or specific Health poll
 # @PRE: User is logged in.
 # @POST: Provides integer count of currently failing dashboards.
-[/DEF:SidebarHealthBadge]
\ No newline at end of file
+# [/DEF:SidebarHealthBadge:Store]