busya
274510fc38
- Replaced @TIER: TRIVIAL with @COMPLEXITY: 1 - Replaced @TIER: STANDARD with @COMPLEXITY: 3 - Replaced @TIER: CRITICAL with @COMPLEXITY: 5 - Manually elevated specific critical/complex components to levels 2 and 4 - Ignored legacy, specs, and node_modules directories - Updated generated semantic map
415 KiB
415 KiB
Project Semantic Map
Compressed view for AI Context. Generated automatically.
- 📦 generate_semantic_map (
Module)- 📝 Scans the codebase to generate a Semantic Map, Module Map, and Compliance Report based on the System Standard.
- 🏗️ Layer: DevOps/Tooling
- 🔒 Invariant: All DEF anchors must have matching closing anchors; TIER determines validation strictness.
- ƒ init (
Function)[TRIVIAL]- 📝 Mock init for self-containment.
- ƒ enter (
Function)[TRIVIAL]- 📝 Mock enter.
- ƒ exit (
Function)[TRIVIAL]- 📝 Mock exit.
- ℂ Tier (
Class)[TRIVIAL]- 📝 Legacy tier buckets retained for backward-compatible reporting.
- ℂ Complexity (
Class)[TRIVIAL]- 📝 Adaptive semantic complexity scale used for validation strictness.
- ℂ Severity (
Class)[TRIVIAL]- 📝 Severity levels for compliance issues.
- ℂ ComplianceIssue (
Class)[TRIVIAL]- 📝 Represents a single compliance issue with severity.
- ℂ SemanticEntity (
Class)[CRITICAL]- 📝 Represents a code entity (Module, Function, Component) found during parsing.
- 🔒 Invariant: start_line is always set; end_line is set upon closure; complexity defaults to 1 unless explicitly raised.
- ƒ init (
Function)- 📝 Initializes a new SemanticEntity instance.
- ƒ has_explicit_complexity (
Function)[TRIVIAL]- 📝 Returns whether the entity explicitly declares complexity metadata.
- ƒ get_complexity (
Function)[TRIVIAL]- 📝 Returns effective complexity with backward compatibility for legacy tiers.
- ƒ to_dict (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ collect_recursive (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 DashboardTypes (
Module)[TRIVIAL]- 📝 TypeScript interfaces for Dashboard entities
- 🏗️ Layer: Domain
- 🧩 Counter (
Component)[TRIVIAL]- 📝 Simple counter demo component
- 🏗️ Layer: UI
- ➡️ WRITES_TO
state
- 📦 stores_module (
Module)- 📝 Global state management using Svelte stores.
- 🏗️ Layer: UI-State
- 📦 plugins (
Data)[TRIVIAL]- 📝 Store for the list of available plugins.
- 📦 tasks (
Data)[TRIVIAL]- 📝 Store for the list of tasks.
- 📦 selectedPlugin (
Data)[TRIVIAL]- 📝 Store for the currently selected plugin.
- 📦 selectedTask (
Data)[TRIVIAL]- 📝 Store for the currently selected task.
- 📦 currentPage (
Data)[TRIVIAL]- 📝 Store for the current page.
- 📦 taskLogs (
Data)[TRIVIAL]- 📝 Store for the logs of the currently selected task.
- ƒ fetchPlugins (
Function)[TRIVIAL]- 📝 Fetches plugins from the API and updates the plugins store.
- ƒ fetchTasks (
Function)[TRIVIAL]- 📝 Fetches tasks from the API and updates the tasks store.
- 📦 toasts_module (
Module)[TRIVIAL]- 📝 Manages toast notifications using a Svelte writable store.
- 🏗️ Layer: UI-State
- 📦 toasts (
Data)[TRIVIAL]- 📝 Writable store containing the list of active toasts.
- ƒ addToast (
Function)[TRIVIAL]- 📝 Adds a new toast message.
- ƒ removeToast (
Function)[TRIVIAL]- 📝 Removes a toast message by ID.
- ƒ buildToastKey (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ shouldSkipDuplicateToast (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 api_module (
Module)- 📝 Handles all communication with the backend API.
- 🏗️ Layer: Infra-API
- ƒ buildApiError (
Function)[TRIVIAL]- 📝 Creates a normalized Error object for failed API responses.
- ƒ notifyApiError (
Function)[TRIVIAL]- 📝 Shows toast for API errors with explicit handling of critical statuses.
- ƒ shouldSuppressApiErrorToast (
Function)[TRIVIAL]- 📝 Avoid noisy toasts for expected non-critical API failures.
- ƒ getWsUrl (
Function)[TRIVIAL]- 📝 Returns the WebSocket URL for a specific task, with fallback logic.
- ƒ getAuthHeaders (
Function)[TRIVIAL]- 📝 Returns headers with Authorization if token exists.
- ƒ fetchApi (
Function)[TRIVIAL]- 📝 Generic GET request wrapper.
- ƒ fetchApiBlob (
Function)[TRIVIAL]- 📝 Generic GET wrapper for binary payloads.
- ƒ postApi (
Function)[TRIVIAL]- 📝 Generic POST request wrapper.
- ƒ requestApi (
Function)[TRIVIAL]- 📝 Generic request wrapper.
- 📦 api (
Data)[TRIVIAL]- 📝 API client object with specific methods.
- 📦 Utils (
Module)[TRIVIAL]- 📝 General utility functions (class merging)
- 🏗️ Layer: Infra
- ƒ cn (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🗄️ authStore (
Store)- 📝 Manages the global authentication state on the frontend.
- 🏗️ Layer: Feature
- 🔗 BINDS_TO ->
Navbar, ProtectedRoute - 📦 AuthState (
Interface)[TRIVIAL]- 📝 Defines the structure of the authentication state.
- ƒ createAuthStore (
Function)[TRIVIAL]- 📝 Creates and configures the auth store with helper methods.
- ƒ setToken (
Function)[TRIVIAL]- 📝 Updates the store with a new JWT token.
- ƒ setUser (
Function)[TRIVIAL]- 📝 Sets the current user profile data.
- ƒ logout (
Function)[TRIVIAL]- 📝 Clears authentication state and storage.
- ƒ setLoading (
Function)[TRIVIAL]- 📝 Updates the loading state.
- 📦 frontend.src.lib.auth.permissions (
Module)- 📝 Shared frontend RBAC utilities for route guards and menu visibility.
- 🏗️ Layer: Domain
- 🔒 Invariant: Admin role always bypasses explicit permission checks.
- ƒ normalizePermissionRequirement (
Function)[TRIVIAL]- 📝 Convert permission requirement string to canonical resource/action tuple.
- ƒ isAdminUser (
Function)[TRIVIAL]- 📝 Determine whether user has Admin role.
- ƒ hasPermission (
Function)[TRIVIAL]- 📝 Check if user has a required resource/action permission.
- ƒ normalizeAction (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.auth.tests.permissions (
Module)- 📝 Verifies frontend RBAC permission parsing and access checks.
- 🏗️ Layer: UI (Tests)
- 📦 Debounce (
Module)[TRIVIAL]- 📝 Debounce utility for limiting function execution rate
- 🏗️ Layer: Infra
- ƒ debounce (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🗄️ health_store (
Store)- 📝 Manage dashboard health summary state and failing counts for UI badges.
- 🏗️ Layer: UI
- 🔗 DEPENDS_ON ->
api.getHealthSummary
- 📦 health (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/stores/health.js
- 🏗️ Layer: Unknown
- ƒ createHealthStore (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refresh (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🗄️ assistantChat (
Store)- 📝 Control assistant chat panel visibility and active conversation binding.
- 🏗️ Layer: UI
- 🔒 Invariant: conversationId persists while panel toggles unless explicitly reset.
- 🔗 BINDS_TO ->
AssistantChatPanel - ƒ toggleAssistantChat (
Function)[TRIVIAL]- 📝 Toggle assistant panel visibility.
- ƒ openAssistantChat (
Function)[TRIVIAL]- 📝 Open assistant panel.
- ƒ closeAssistantChat (
Function)[TRIVIAL]- 📝 Close assistant panel.
- ƒ setAssistantConversationId (
Function)[TRIVIAL]- 📝 Bind current conversation id in UI state.
- 🗄️ taskDrawer (
Store)[CRITICAL]- 📝 Manage Task Drawer visibility and resource-to-task mapping
- 🏗️ Layer: UI
- 🔒 Invariant: resourceTaskMap always reflects current task associations
- 📦 taskDrawer (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/stores/taskDrawer.js
- 🏗️ Layer: Unknown
- ƒ readAutoOpenTaskDrawerPreference (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openDrawerForTask (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ setTaskDrawerAutoOpenPreference (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getTaskDrawerAutoOpenPreference (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openDrawerForTaskIfPreferred (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openDrawer (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ closeDrawer (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ updateResourceTask (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getTaskForResource (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🗄️ sidebar (
Store)- 📝 Manage sidebar visibility and navigation state
- 🏗️ Layer: UI
- 🔒 Invariant: isExpanded state is always synced with localStorage
- 📦 sidebar (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/stores/sidebar.js
- 🏗️ Layer: Unknown
- ƒ toggleSidebar (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ setActiveItem (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ setMobileOpen (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ closeMobile (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleMobileSidebar (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🗄️ environmentContext (
Store)- 📝 Global selected environment context for navigation and safety cues.
- 🏗️ Layer: UI-State
- 📦 environmentContext (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/stores/environmentContext.js
- 🏗️ Layer: Unknown
- ƒ getStoredSelectedEnvId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ persistSelectedEnvId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ hasAuthToken (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveSelectedEnvId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ applySelectedEnvId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refreshEnvironmentContext (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ initializeEnvironmentContext (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ setSelectedEnvironment (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🗄️ activity (
Store)- 📝 Track active task count for navbar indicator
- 🏗️ Layer: UI
- 🔗 DEPENDS_ON ->
WebSocket connection, taskDrawer store
- 📦 frontend.src.lib.stores.tests.test_sidebar (
Module)- 📝 Unit tests for sidebar store
- 🏗️ Layer: UI
- 📦 frontend.src.lib.stores.tests.sidebar (
Module)- 📝 Unit tests for sidebar store
- 🏗️ Layer: Domain (Tests)
- 🔒 Invariant: Sidebar store transitions must be deterministic across desktop/mobile toggles.
- ƒ test_sidebar_initial_state (
Function)[TRIVIAL]- 📝 Verify initial sidebar store values when no persisted state is available.
- ƒ test_toggleSidebar (
Function)[TRIVIAL]- 📝 Verify desktop sidebar expansion toggles deterministically.
- ƒ test_setActiveItem (
Function)[TRIVIAL] - ƒ test_mobile_functions (
Function)[TRIVIAL]
- 📦 frontend.src.lib.stores.tests.test_activity (
Module)- 📝 Unit tests for activity store
- 🏗️ Layer: UI
- 🔗 DEPENDS_ON ->
frontend.src.lib.stores.taskDrawer
- 📦 setupTests (
Module)- 📝 Global test setup with mocks for SvelteKit modules
- 🏗️ Layer: UI
- 📦 frontend.src.lib.stores.tests.test_taskDrawer (
Module)- 📝 Unit tests for task drawer store
- 🏗️ Layer: UI
- 🔒 Invariant: Store state transitions remain deterministic for open/close and task-status mapping.
- 📦 frontend.src.lib.stores.tests.assistantChat (
Module)- 📝 Validate assistant chat store visibility and conversation binding transitions.
- 🏗️ Layer: UI Tests
- 🔒 Invariant: Each test starts from default closed state.
- 🔗 DEPENDS_ON ->
assistantChatStore - ƒ assistantChatStore_tests (
Function)- 📝 Group store unit scenarios for assistant panel behavior.
- 📦 navigation (
Mock)[TRIVIAL]- 📝 Mock for $app/navigation in tests
- 📦 stores (
Mock)[TRIVIAL]- 📝 Mock for $app/stores in tests
- 📦 environment (
Mock)[TRIVIAL]- 📝 Mock for $app/environment in tests
- 📦 mock_env_public (
Module)- 📝 Mock for $env/static/public SvelteKit module in vitest
- 🏗️ Layer: UI (Tests)
- 📦 frontend.src.lib.api.reports (
Module)[CRITICAL]- 📝 Wrapper-based reports API client for list/detail retrieval without direct native fetch usage.
- 🏗️ Layer: Infra
- 🔒 Invariant: Uses existing api wrapper methods and returns structured errors for UI-state mapping.
- 🔗 DEPENDS_ON ->
DEF:api_module - ƒ buildReportQueryString (
Function)[TRIVIAL]- 📝 Build query string for reports list endpoint from filter options.
- ƒ normalizeApiError (
Function)[TRIVIAL]- 📝 Convert unknown API exceptions into deterministic UI-consumable error objects.
- ƒ getReports (
Function)[TRIVIAL]- 📝 Fetch unified report list using existing request wrapper.
- ƒ getReportDetail (
Function)[TRIVIAL]- 📝 Fetch one report detail by report_id.
- 📦 frontend.src.lib.api.assistant (
Module)- 📝 API client wrapper for assistant chat, confirmation actions, and history retrieval.
- 🏗️ Layer: Infra-API
- 🔒 Invariant: All assistant requests must use requestApi wrapper (no native fetch).
- 🔗 DEPENDS_ON ->
frontend.src.lib.api.api_module - ƒ sendAssistantMessage (
Function)[TRIVIAL]- 📝 Send a user message to assistant orchestrator endpoint.
- ƒ confirmAssistantOperation (
Function)[TRIVIAL]- 📝 Confirm a pending risky assistant operation.
- ƒ cancelAssistantOperation (
Function)[TRIVIAL]- 📝 Cancel a pending risky assistant operation.
- ƒ getAssistantHistory (
Function)[TRIVIAL]- 📝 Retrieve paginated assistant conversation history.
- ƒ getAssistantConversations (
Function)[TRIVIAL]- 📝 Retrieve paginated conversation list for assistant sidebar/history switcher.
- ƒ deleteAssistantConversation (
Function)[TRIVIAL]- 📝 Soft-delete or hard-delete a conversation.
- 📦 frontend.src.lib.api.tests.reports_api (
Module)- 📝 Unit tests for reports API client functions: query string building, error normalization, and fetch wrappers.
- 🏗️ Layer: Infra (Tests)
- 🔒 Invariant: Pure functions produce deterministic output. Async wrappers propagate structured errors.
- ℂ TestBuildReportQueryString (
Class)[TRIVIAL]- 📝 Validate query string construction from filter options.
- ℂ TestNormalizeApiError (
Class)[TRIVIAL]- 📝 Validate error normalization for UI-state mapping.
- ℂ TestGetReportsAsync (
Class)[TRIVIAL]- 📝 Validate getReports and getReportDetail with mocked api.fetchApi.
- 🧩 Select (
Component)[TRIVIAL]- 📝 Standardized dropdown selection component.
- 🏗️ Layer: Atom
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props
- 📦 ui (
Module)[TRIVIAL]- 📝 Central export point for standardized UI components.
- 🏗️ Layer: Atom
- 🔒 Invariant: All components exported here must follow Semantic Protocol.
- 🧩 PageHeader (
Component)[TRIVIAL]- 📝 Standardized page header with title and action area.
- 🏗️ Layer: Atom
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
props
- 🧩 Card (
Component)[TRIVIAL]- 📝 Standardized container with padding and elevation.
- 🏗️ Layer: Atom
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
props
- 🧩 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
- 🧩 Input (
Component)[TRIVIAL]- 📝 Standardized text input component with label and error handling.
- 🏗️ Layer: Atom
- 🔒 Invariant: Consistent spacing and focus states.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props
- 🧩 LanguageSwitcher (
Component)[TRIVIAL]- 📝 Dropdown component to switch between supported languages.
- 🏗️ Layer: Atom
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
locale - 🔗 BINDS_TO ->
i18n.locale
- 📦 i18n (
Module)- 📝 Determines the starting locale.
- 🏗️ Layer: Infra
- 🔒 Invariant: Persistence is handled via LocalStorage.
- 🔗 DEPENDS_ON ->
locales/ru.json - 🔗 DEPENDS_ON ->
locales/en.json - 🗄️ locale (
Store)[TRIVIAL]- 📝 Holds the current active locale string.
- 🗄️ t (
Store)[TRIVIAL]- 📝 Derived store providing the translation dictionary.
- ƒ _ (
Function)[TRIVIAL]- 📝 Get translation by key path.
- 🧩 AssistantChatPanel (
Component)- 📝 Slide-out assistant chat panel for natural language command execution and task tracking.
- 🏗️ Layer: UI
- 🔒 Invariant: Risky operations are executed only through explicit confirm action.
- ⬅️ READS_FROM
app - ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - 🔗 BINDS_TO ->
assistantChatStore - 🔗 CALLS ->
frontend.src.lib.api.assistant - 🔗 DISPATCHES ->
taskDrawerStore - ƒ 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
- ƒ buildConversationTitle (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ setConversationFilter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatConversationTime (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadLlmStatus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.components.assistant.tests.assistant_first_message_integration (
Module)- 📝 Verify first optimistic user message stays visible while a new conversation request is pending.
- 🏗️ Layer: UI Tests
- 🔒 Invariant: Starting a new conversation must not trigger history reload that overwrites the first local user message.
- ƒ assistant_first_message_tests (
Function)- 📝 Guard optimistic first-message UX against history reload race in new conversation flow.
- 📦 frontend.src.lib.components.assistant.tests.assistant_chat_integration (
Module)- 📝 Contract-level integration checks for assistant chat panel implementation and localization wiring.
- 🏗️ Layer: UI Tests
- 🔒 Invariant: Critical assistant UX states and action hooks remain present in component source.
- ƒ readJson (
Function)[TRIVIAL]- 📝 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.
- 🧩 HealthMatrix (
Component)- 📝 Visual grid/matrix representing the health status of dashboards.
- 🏗️ Layer: UI/Component
- ⬅️ READS_FROM
state - ⬅️ READS_FROM
derived - ⬅️ READS_FROM
lib
- 🧩 PolicyForm (
Component)- 📝 Form for creating and editing validation policies.
- 🏗️ Layer: UI/Component
- ⬅️ READS_FROM
state - ⬅️ READS_FROM
derived - ➡️ WRITES_TO
props
- 📦 PolicyForm (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/health/PolicyForm.svelte
- 🏗️ Layer: Unknown
- ƒ getSafePolicy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getSafeEnvironments (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ buildFormData (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSubmit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleDay (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 ReportCard (
Component)- 📝 Render one report with explicit textual type label and profile-driven visual variant.
- 🏗️ Layer: UI
- 🔒 Invariant: Unknown task type always uses fallback profile.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
props - ➡️ WRITES_TO
derived - 🔗 DEPENDS_ON ->
frontend/src/lib/components/reports/reportTypeProfiles.js - 🔗 DEPENDS_ON ->
frontend/src/lib/i18n/index.ts
- 📦 ReportCard (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/reports/ReportCard.svelte
- 🏗️ Layer: Unknown
- ƒ getStatusClass (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getStatusLabel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatDate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ onSelect (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 ReportsList (
Component)- 📝 Render unified list of normalized reports with canonical minimum fields.
- 🏗️ Layer: UI
- 🔒 Invariant: Every rendered row shows task_type label, status, summary, and updated_at.
- ➡️ WRITES_TO
props - 🔗 DEPENDS_ON ->
frontend/src/lib/i18n/index.ts
- 📦 ReportsList (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/reports/ReportsList.svelte
- 🏗️ Layer: Unknown
- ƒ handleSelect (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.components.reports.reportTypeProfiles (
Module)[CRITICAL]- 📝 Deterministic mapping from report task_type to visual profile with one fallback.
- 🏗️ Layer: UI
- 🔒 Invariant: Unknown type always resolves to fallback profile.
- 🔗 DEPENDS_ON ->
frontend/src/lib/i18n/index.ts - ƒ getReportTypeProfile (
Function)[TRIVIAL]- 📝 Resolve visual profile by task type with guaranteed fallback.
- 🧩 ReportDetailPanel (
Component)- 📝 Display detailed report context with diagnostics and actionable recovery guidance.
- 🏗️ Layer: UI
- 🔒 Invariant: Failed/partial reports surface actionable hints when available.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
props - ⬅️ READS_FROM
t - 🔗 DEPENDS_ON ->
frontend/src/lib/i18n/index.ts
- 📦 ReportDetailPanel (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/reports/ReportDetailPanel.svelte
- 🏗️ Layer: Unknown
- ƒ notProvided (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatDate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.components.reports.tests.reports_filter_performance (
Module)- 📝 Guard test for report filter responsiveness on moderate in-memory dataset.
- 🏗️ Layer: UI (Tests)
- ƒ applyFilters (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ makeDataset (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.components.reports.tests.reports_page.integration (
Module)- 📝 Integration-style checks for unified mixed-type reports rendering expectations.
- 🏗️ Layer: UI (Tests)
- 🔒 Invariant: Mixed fixture includes all supported report types in one list.
- ƒ collectVisibleTypeLabels (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.components.reports.tests.report_type_profiles (
Module)- 📝 Validate report type profile mapping and unknown fallback behavior.
- 🏗️ Layer: UI (Tests)
- 🔒 Invariant: Unknown task_type always resolves to the fallback profile.
- 📦 frontend.src.lib.components.reports.tests.reports_list.ux (
Module)- 📝 Test ReportsList component iteration and event forwarding.
- 🏗️ Layer: UI
- 📦 frontend.src.lib.components.reports.tests.report_card.ux (
Module)- 📝 Test UX states and transitions for ReportCard component
- 🏗️ Layer: UI
- 🔒 Invariant: Each test asserts at least one observable UX contract outcome.
- 📦 frontend.src.lib.components.reports.tests.report_detail.ux (
Module)- 📝 Test UX states and recovery for ReportDetailPanel component
- 🏗️ Layer: UI
- 🔒 Invariant: Detail UX tests keep placeholder-safe rendering and recovery visibility verifiable.
- 📦 frontend.src.lib.components.reports.tests.report_detail.integration (
Module)- 📝 Validate detail-panel behavior for failed reports and recovery guidance visibility.
- 🏗️ Layer: UI (Tests)
- 🔒 Invariant: Failed report detail exposes actionable next actions when available.
- ƒ buildFailedDetailFixture (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 reports.fixtures (
Module)- 📝 Shared frontend fixtures for unified reports states.
- 🏗️ Layer: UI
- 🧩 Sidebar (
Component)- 📝 Persistent left sidebar with resource categories navigation
- 🏗️ Layer: UI
- 🔒 Invariant: Always shows active category and item
- ⬅️ READS_FROM
app - ⬅️ READS_FROM
lib - ➡️ WRITES_TO
derived - 🔗 BINDS_TO ->
sidebarStore
- 📦 Sidebar (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/layout/Sidebar.svelte
- 🏗️ Layer: Unknown
- ƒ withExpandedCategory (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleExpandedCategory (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleItemClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleCategoryToggle (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSubItemClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleToggleClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleOverlayClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 TopNavbar (
Component)- 📝 Unified top navigation bar with Logo, Search, Activity, and User menu
- 🏗️ Layer: UI
- 🔒 Invariant: Always visible on non-login pages
- ⬅️ READS_FROM
app - ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - 🔗 BINDS_TO ->
activityStore, authStore
- 📦 TopNavbar (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/layout/TopNavbar.svelte
- 🏗️ Layer: Unknown
- ƒ toggleUserMenu (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ closeUserMenu (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleLogout (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleActivityClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleAssistantClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ hydrateTaskDrawerPreference (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSearchFocus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ clearSearchState (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleDocumentClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleHamburgerClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGlobalEnvironmentChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ buildSearchResultSections (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ triggerSearch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSearchInput (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openSearchResult (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSearchKeydown (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 Breadcrumbs (
Component)- 📝 Display page hierarchy navigation
- 🏗️ Layer: UI
- 🔒 Invariant: Always shows current page path
- ⬅️ READS_FROM
app - ⬅️ READS_FROM
lib - ➡️ WRITES_TO
props - 🔗 DEPENDS_ON ->
page store
- 📦 Breadcrumbs (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/layout/Breadcrumbs.svelte
- 🏗️ Layer: Unknown
- ƒ getBreadcrumbs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatBreadcrumbLabel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getCrumbMeta (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 TaskDrawer (
Component)- 📝 Global task drawer for monitoring background operations
- 🏗️ Layer: UI
- 🔒 Invariant: Drawer shows logs for active task or remains closed
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - ➡️ WRITES_TO
derived - 🔗 BINDS_TO ->
taskDrawerStore, assistantChatStore, WebSocket - ƒ disconnectWebSocket (
Function)- 📝 Disconnects the active WebSocket connection
- ƒ loadRecentTasks (
Function)[TRIVIAL]- 📝 Load recent tasks for list mode display
- ƒ selectTask (
Function)[TRIVIAL]- 📝 Select a task from list to view details
- ƒ goBackToList (
Function)- 📝 Return to task list view from task details
- 📦 TaskDrawer (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/layout/TaskDrawer.svelte
- 🏗️ Layer: Unknown
- ƒ handleClose (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ goToReportsPage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGlobalKeydown (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeTaskId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ isTaskFinished (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveLlmValidationStatus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ llmValidationBadgeClass (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ stopTaskDetailsPolling (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadEnvironmentOptions (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveEnvironmentName (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveEnvironmentId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeSupersetBaseUrl (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveSupersetDashboardUrl (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadActiveTaskDetails (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ extractPrimaryDashboardId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ buildTaskSummary (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleOpenDashboardDeepLink (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleShowDiff (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleOpenLlmReport (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ connectWebSocket (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.components.layout.sidebarNavigation (
Module)- 📝 Build sidebar navigation categories filtered by current user permissions.
- 🏗️ Layer: UI
- 🔒 Invariant: Admin role can access all categories and subitems through permission utility.
- 🔗 DEPENDS_ON ->
frontend.src.lib.auth.permissions.hasPermission - ƒ isItemAllowed (
Function)[TRIVIAL]- 📝 Check whether a single menu node can be shown for a given user.
- ƒ buildSidebarCategories (
Function)[TRIVIAL]- 📝 Build translated sidebar categories and filter them by RBAC permissions.
- 📦 test_breadcrumbs.svelte (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/lib/components/layout/tests/test_breadcrumbs.svelte.js
- 🏗️ Layer: Unknown
- ƒ getBreadcrumbs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatBreadcrumbLabel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.lib.components.layout.tests.sidebarNavigation (
Module)- 📝 Verifies RBAC-based sidebar category and subitem visibility.
- 🏗️ Layer: UI (Tests)
- ƒ makeUser (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 ErrorPage (
Page)- 📝 Global error page displaying HTTP status and messages
- 🏗️ Layer: UI
- 📦 RootLayoutConfig (
Module)[TRIVIAL]- 📝 Root layout configuration (SPA mode)
- 🏗️ Layer: Infra
- 📦 HomePage (
Page)[CRITICAL]- 📝 Redirect to preferred start page from profile settings with safe dashboards fallback.
- 🏗️ Layer: UI
- 🔒 Invariant: Redirect target resolves to one of /dashboards, /datasets, /reports.
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/+page.svelte
- 🏗️ Layer: Unknown
- ƒ normalizeStartPage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveStartPagePath (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ redirectToStartPage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ load (
Function)[TRIVIAL]- 📝 Loads initial plugin data for the dashboard.
- 📦 layout (
Module)- 📝 Bind global layout shell and conditional login/full-app rendering.
- 🏗️ Layer: UI
- 🔒 Invariant: Login route bypasses shell; all other routes are wrapped by ProtectedRoute.
- 🔗 BINDS_TO ->
frontend.src.lib.components.layout.Sidebar
- 📦 DatasetHub (
Page)- 📝 Dataset Hub - Dedicated hub for datasets with mapping progress
- 🏗️ Layer: UI
- 🔒 Invariant: Always shows datasets for the active environment from context store
- 🔗 BINDS_TO ->
sidebarStore, taskDrawerStore
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/datasets/+page.svelte
- 🏗️ Layer: Unknown
- ƒ loadDatasets (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSearch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handlePageChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handlePageSizeChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ updateSelectionState (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleCheckboxChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSelectAll (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSelectVisible (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleAction (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleBulkMapColumns (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleBulkGenerateDocs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleTaskStatusClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getTaskStatusIcon (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getMappingProgressClass (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 DatasetDetail (
Page)- 📝 Dataset Detail View - Shows detailed dataset information with columns, SQL, and linked dashboards
- 🏗️ Layer: UI
- 🔒 Invariant: Always shows dataset details when loaded
- 🔗 BINDS_TO ->
sidebarStore
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/datasets/[id]/+page.svelte
- 🏗️ Layer: Unknown
- ƒ loadDatasetDetail (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ navigateToDashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ goBack (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getColumnTypeClass (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getMappingProgress (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 UnifiedReportsPage (
Component)[CRITICAL]- 📝 Unified reports page with filtering and resilient UX states for mixed task types.
- 🏗️ Layer: UI
- 🔒 Invariant: List state remains deterministic for active filter set.
- ⬅️ READS_FROM
lib - ⬅️ READS_FROM
t - ➡️ WRITES_TO
t - 🔗 DEPENDS_ON ->
frontend/src/lib/api/reports.js - 🔗 DEPENDS_ON ->
frontend/src/lib/components/reports/ReportsList.svelte
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/reports/+page.svelte
- 🏗️ Layer: Unknown
- ƒ buildQuery (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadReports (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ hasActiveFilters (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ clearFilters (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ onFilterChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ onSelectReport (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/reports/llm/[taskId]/+page.svelte
- 🏗️ Layer: Unknown
- ƒ formatDate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatMs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getDashboardCheckResult (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getCheckResultClasses (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadReport (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ backToReports (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openTaskDetails (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ cleanupScreenshotBlobUrls (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadScreenshotBlobUrls (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openScreenshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.routes.reports.llm.taskid.report_page_contract_test (
Module)- 📝 Protect the LLM report page from self-triggering screenshot load effects.
- 🏗️ Layer: UI Tests
- ƒ llm_report_screenshot_effect_contract (
Function)- 📝 Ensure screenshot loading stays untracked from blob-url mutation state.
- 🧩 LoginPage (
Component)- 📝 Provides the user interface for local and ADFS authentication.
- 🏗️ Layer: UI
- 🔒 Invariant: Shows both local login form and ADFS SSO button.
- ⬅️ READS_FROM
app - ⬅️ READS_FROM
lib - ➡️ WRITES_TO
t - 🔗 CALLS ->
api.auth.login - ƒ handleLogin (
Function)[TRIVIAL]- 📝 Submits the local login form to the backend.
- ƒ handleADFSLogin (
Function)[TRIVIAL]- 📝 Redirects the user to the ADFS login endpoint.
- 📦 StorageIndexPage (
Page)[TRIVIAL]- 📝 Redirect to the backups page as the default storage view.
- 🏗️ Layer: Page
- 🔒 Invariant: Always redirects to /storage/backups.
- 📦 StorageReposPage (
Page)[TRIVIAL]- ƒ fetchEnvironments (
Function)[TRIVIAL]- 📝 Fetches the list of available environments.
- ƒ fetchDashboards (
Function)[TRIVIAL]- 📝 Fetches dashboards for a specific environment.
- ƒ filterDashboardsWithRepositories (
Function)[TRIVIAL]- 📝 Keep only dashboards that already have initialized Git repositories.
- ƒ fetchEnvironments (
- 📦 DashboardHub (
Page)- 📝 Dashboard Hub - Central hub for managing dashboards with Git status and task actions
- 🏗️ Layer: UI
- 🔒 Invariant: Always shows dashboards for the active environment from context store
- 🔗 BINDS_TO ->
sidebarStore, taskDrawerStore - ƒ DashboardHub.normalizeTaskStatus (
Function)[TRIVIAL]- 📝 Normalize raw task status to stable lowercase token for UI.
- ƒ DashboardHub.normalizeValidationStatus (
Function)[TRIVIAL]- 📝 Normalize validation status to pass/fail/warn/unknown.
- ƒ DashboardHub.getValidationBadgeClass (
Function)[TRIVIAL]- 📝 Map validation level to badge class tuple.
- ƒ DashboardHub.getValidationLabel (
Function)[TRIVIAL]- 📝 Map normalized validation level to compact UI label.
- ƒ DashboardHub.normalizeOwners (
Function)[TRIVIAL]- 📝 Normalize owners payload to unique non-empty display labels.
- ƒ DashboardHub.loadDashboards (
Function)[TRIVIAL]- 📝 Load full dashboard dataset for current environment and hydrate grid projection.
- ƒ DashboardHub.handleTemporaryShowAll (
Function)[TRIVIAL]- 📝 Temporarily disable profile-default dashboard filter for current page context.
- ƒ DashboardHub.handleRestoreProfileFilter (
Function)[TRIVIAL]- 📝 Re-enable persisted profile-default filtering after temporary override.
- ƒ DashboardHub.formatDate (
Function)[TRIVIAL]- 📝 Convert ISO timestamp to locale date string.
- ƒ DashboardHub.getGitSummaryLabel (
Function)[TRIVIAL]- 📝 Compute stable text label for git state column.
- ƒ DashboardHub.getLlmSummaryLabel (
Function)[TRIVIAL]- 📝 Compute normalized LLM validation summary label.
- ƒ DashboardHub.getColumnCellValue (
Function)[TRIVIAL]- 📝 Resolve comparable/filterable display value for any grid column.
- ƒ DashboardHub.getFilterOptions (
Function)[TRIVIAL]- 📝 Build unique sorted value list for a column filter dropdown.
- ƒ DashboardHub.getVisibleFilterOptions (
Function)[TRIVIAL]- 📝 Apply in-dropdown search over full filter options.
- ƒ DashboardHub.toggleFilterDropdown (
Function)[TRIVIAL]- 📝 Toggle active column filter popover.
- ƒ DashboardHub.toggleFilterValue (
Function)[TRIVIAL]- 📝 Add/remove specific filter value and reapply projection.
- ƒ DashboardHub.clearColumnFilter (
Function)[TRIVIAL]- 📝 Reset selected values for one column.
- ƒ DashboardHub.selectAllColumnFilterValues (
Function)[TRIVIAL]- 📝 Select all currently visible values in filter popover.
- ƒ DashboardHub.updateColumnFilterSearch (
Function)[TRIVIAL]- 📝 Update local search token for one filter popover.
- ƒ DashboardHub.hasColumnFilter (
Function)[TRIVIAL]- 📝 Determine if column has active selected values.
- ƒ DashboardHub.doesDashboardPassColumnFilters (
Function)[TRIVIAL]- 📝 Evaluate dashboard row against all active column filters.
- ƒ DashboardHub.getSortValue (
Function)[TRIVIAL]- 📝 Compute stable comparable sort key for chosen column.
- ƒ DashboardHub.handleSort (
Function)[TRIVIAL]- 📝 Toggle or switch sort order and reapply grid projection.
- ƒ DashboardHub.getSortIndicator (
Function)[TRIVIAL]- 📝 Return visual indicator for active/inactive sort header.
- ƒ DashboardHub.applyGridTransforms (
Function)[TRIVIAL]- 📝 Apply search + column filters + sort + pagination to grid data.
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/dashboards/+page.svelte
- 🏗️ Layer: Unknown
- ƒ handleDocumentClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeTaskStatus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeValidationStatus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getValidationBadgeClass (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getValidationLabel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeOwners (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadDashboards (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSearch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handlePageChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handlePageSizeChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleTemporaryShowAll (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleRestoreProfileFilter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ updateSelectionState (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ replaceSelectedIds (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ clearSelectedIds (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleCheckboxChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSelectAll (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSelectVisible (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatDate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getGitSummaryLabel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getLlmSummaryLabel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getColumnCellValue (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getFilterOptions (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getVisibleFilterOptions (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleFilterDropdown (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleFilterValue (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ clearColumnFilter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ selectAllColumnFilterValues (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ updateColumnFilterSearch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ hasColumnFilter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ doesDashboardPassColumnFilters (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getSortValue (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSort (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getSortIndicator (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ applyGridTransforms (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleActionDropdown (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ closeActionDropdown (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleAction (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleValidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleTargetEnvChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadDatabases (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleMappingUpdate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadDbMappings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ calculateDryRun (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleBulkMigrate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleBulkBackup (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleTaskStatusClick (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ navigateToDashboardDetail (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getStatusBadgeClass (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ isGitBusy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ setGitBusy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ ensureGitConfigs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ updateDashboardGitState (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeRepositoryStatusPayload (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ fetchDashboardGitStatusesBatch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refreshDashboardGitState (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ hydrateVisibleGitStatusesBatch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGitInit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGitSync (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGitCommit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGitPull (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGitPush (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getTaskStatusIcon (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getPaginationRange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleEnvironmentCreated (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.routes.dashboards.tests.dashboard_profile_override_integration (
Module)- 📝 Verifies temporary show-all override and restore-on-return behavior for profile-default dashboard filtering.
- 🏗️ Layer: UI (Tests)
- ƒ buildFilteredResponse (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ buildUnfilteredResponse (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 HealthCenterPage (
Component)- 📝 Main page for the Dashboard Health Center.
- 🏗️ Layer: UI/Page
- ⬅️ READS_FROM
state - ⬅️ READS_FROM
derived - ⬅️ READS_FROM
lib - 🔗 DEPENDS_ON ->
frontend.src.lib.components.health.HealthMatrix - 🔗 CALLS ->
frontend.src.lib.api.api_module - ƒ loadData (
Function)[TRIVIAL]- 📝 Load health summary rows and environment options for the current filter.
- ƒ handleEnvChange (
Function)[TRIVIAL]- 📝 Apply environment filter and trigger health summary reload.
- ƒ handleDeleteReport (
Function)[TRIVIAL]- 📝 Delete one health report row with confirmation and optimistic button lock.
- 📦 frontend.src.routes.dashboards.health.tests.health_page_integration (
Module)- 📝 Lock dashboard health page contract for slug navigation and report deletion.
- 🏗️ Layer: UI Tests
- 📦 DashboardDetail (
Page)- 📝 Dashboard Detail View - Overview of charts and datasets linked to a dashboard
- 🏗️ Layer: UI
- 🔒 Invariant: Shows dashboard metadata, charts, and datasets for selected environment
- 🔗 BINDS_TO ->
dashboard detail API
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/dashboards/[id]/+page.svelte
- 🏗️ Layer: Unknown
- ƒ loadDashboardPage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadDashboardDetail (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadTaskHistory (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ releaseThumbnailUrl (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadThumbnail (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ runBackupTask (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ runLlmValidationTask (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openLlmReport (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toTaskTypeLabel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getTaskStatusClasses (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getValidationStatus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getValidationStatusClasses (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ goBack (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openDataset (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ formatDate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadLlmStatus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ hasGitRepository (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveGitSyncState (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ allChangedFiles (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ countChangedByAnyPath (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getGitStatusMeta (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadGitStatus (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadGitDiffPreview (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ runGitSyncAndOpenCommit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ runGitPull (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ runGitPush (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleBranchChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 AdminRolesPage (
Component)- 📝 UI for managing system roles and their permissions.
- 🏗️ Layer: Domain
- 🔒 Invariant: Only accessible by users with Admin role.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
t - ⬅️ READS_FROM
t - 🔗 DEPENDS_ON ->
frontend.src.services.adminService - 🔗 DEPENDS_ON ->
frontend.src.components.auth.ProtectedRoute - ƒ loadData (
Function)[TRIVIAL]- 📝 Fetches roles and available permissions.
- ƒ openCreateModal (
Function)[TRIVIAL]- 📝 Initializes state for creating a new role.
- ƒ openEditModal (
Function)[TRIVIAL]- 📝 Initializes state for editing an existing role.
- ƒ handleSaveRole (
Function)[TRIVIAL]- 📝 Submits role data (create or update).
- ƒ handleDeleteRole (
Function)[TRIVIAL]- 📝 Deletes a role after confirmation.
- 🧩 AdminUsersPage (
Component)[TRIVIAL]- 📝 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 - 🔗 DEPENDS_ON ->
frontend.src.services.adminService - 🔗 DEPENDS_ON ->
frontend.src.components.auth.ProtectedRoute - ƒ loadData (
Function)[TRIVIAL]- 📝 Fetches users and roles from the backend.
- ƒ openCreateModal (
Function)[TRIVIAL]- 📝 Prepares the form for creating a new user.
- ƒ openEditModal (
Function)[TRIVIAL]- 📝 Prepares the form for editing an existing user.
- ƒ handleSaveUser (
Function)[TRIVIAL]- 📝 Submits user data to the backend (create or update).
- ƒ handleDeleteUser (
Function)[TRIVIAL]- 📝 Deletes a user after confirmation.
- 🧩 AdminSettingsPage (
Component)- 📝 UI for configuring Active Directory Group to local Role mappings for ADFS SSO and logging settings.
- 🏗️ Layer: Feature
- 🔒 Invariant: Only accessible by users with "admin:settings" permission.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
t - ⬅️ READS_FROM
t - 🔗 DEPENDS_ON ->
frontend.src.services.adminService - 🔗 DEPENDS_ON ->
frontend.src.components.auth.ProtectedRoute - ƒ loadData (
Function)[TRIVIAL]- 📝 Fetches AD mappings and roles from the backend to populate the UI.
- ƒ handleCreateMapping (
Function)[TRIVIAL]- 📝 Submits a new AD Group to Role mapping to the backend.
- ƒ loadLoggingConfig (
Function)[TRIVIAL]- 📝 Fetches current logging configuration from the backend.
- ƒ saveLoggingConfig (
Function)[TRIVIAL]- 📝 Saves logging configuration to the backend.
- 🧩 LLMSettingsPage (
Component)- 📝 Admin settings page for LLM provider configuration.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
t - ➡️ WRITES_TO
t - 🔗 CALLS ->
frontend/src/components/llm/ProviderConfig.svelte
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/admin/settings/llm/+page.svelte
- 🏗️ Layer: Unknown
- ƒ isMultimodalModel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getProviderById (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ fetchProviders (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ saveSettings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 MigrationDashboard (
Component)[TRIVIAL]- 📝 Orchestrate migration UI workflow and route user actions to backend APIs and task store.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - ⬅️ READS_FROM
effect - ƒ fetchEnvironments (
Function)[TRIVIAL]- 📝 Fetches the list of environments from the API.
- ƒ fetchDashboards (
Function)[TRIVIAL]- 📝 Fetches dashboards for the selected source environment.
- ▦ ReactiveDashboardFetch (
Block)[TRIVIAL]- 📝 Automatically fetch dashboards when the source environment is changed.
- ƒ fetchDatabases (
Function)[TRIVIAL]- 📝 Fetches databases from both environments and gets suggestions.
- ƒ handleMappingUpdate (
Function)[TRIVIAL]- 📝 Saves a mapping to the backend.
- ƒ handleViewLogs (
Function)[TRIVIAL]- 📝 Opens the log viewer for a specific task.
- ƒ handlePasswordPrompt (
Function)[TRIVIAL]- 📝 Reactive logic to show password prompt when a task is awaiting input.
- ▦ ReactivePasswordPrompt (
Block)[TRIVIAL]- 📝 Monitor selected task for input requests and trigger password prompt.
- ƒ handleResumeMigration (
Function)[TRIVIAL]- 📝 Resumes a migration task with provided passwords.
- ƒ startMigration (
Function)[TRIVIAL]- 📝 Initiates the migration process by sending the selection to the backend.
- ƒ startDryRun (
Function)[TRIVIAL]- 📝 Performs a dry-run migration to identify potential risks and changes.
- ▦ MigrationDashboardView (
Block)[TRIVIAL]- 📝 Render migration configuration controls, action CTAs, dry-run results, and modal entry points.
- ▦ MigrationHeader (
Block)[TRIVIAL] - ▦ TaskHistorySection (
Block)[TRIVIAL] - ▦ ActiveTaskSection (
Block)[TRIVIAL] - ▦ EnvironmentSelectionSection (
Block)[TRIVIAL] - 🧩 DashboardSelectionSection (
Component)[TRIVIAL] - ▦ MigrationOptionsSection (
Block)[TRIVIAL] - ▦ DryRunResultsSection (
Block)[TRIVIAL] - ▦ MigrationModals (
Block)[TRIVIAL]- 📝 Render overlay components for log viewing and password entry.
- ▦ MappingsPageScript (
Block)[TRIVIAL]- 📝 Define imports, state, and handlers that drive migration mappings page FSM.
- 🔗 CALLS ->
fetchEnvironments - 🔗 CALLS ->
fetchDatabases - 🔗 CALLS ->
handleUpdate - ▦ Imports (
Block)[TRIVIAL] - 🗄️ UiState (
Store)[CRITICAL]- 📝 Maintain local page state for environments, fetched databases, mappings, suggestions, and UX messages.
- ƒ belief_scope (
Function)[TRIVIAL]- 📝 Frontend semantic scope wrapper for CRITICAL trace boundaries without changing business behavior.
- ƒ fetchEnvironments (
Function)[TRIVIAL]- 📝 Load environment options for source/target selectors on initial mount.
- ƒ fetchDatabases (
Function)[TRIVIAL]- 📝 Fetch both environment database catalogs, existing mappings, and suggested matches.
- ƒ handleUpdate (
Function)[TRIVIAL]- 📝 Persist a selected mapping pair and reconcile local mapping list by source database UUID.
- ▦ MappingsPageTemplate (
Block)[TRIVIAL] - 🧩 ProfilePage (
Component)[CRITICAL]- 📝 Manage user profile sections for read-only security access, Git identity/token configuration, and UI preferences with resilient save/cancel UX.
- 🏗️ Layer: UI
- 🔒 Invariant: Save operations mutate only current user's preference payload via profile API.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - ➡️ WRITES_TO
derived - 🔗 BINDS_TO ->
i18n - 🔗 BINDS_TO ->
api_module - 🔗 BINDS_TO ->
environmentContext - 🔗 BINDS_TO ->
taskDrawer
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/profile/+page.svelte
- 🏗️ Layer: Unknown
- ƒ createSecuritySummaryDefault (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeStartPage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeDensity (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ parseValidationErrorsFromError (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ setSavedSnapshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ syncLocalUiPreferenceCaches (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ applyPreferenceResponse (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadPreference (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadLookupCandidates (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSelectCandidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleGitTokenInput (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleClearGitToken (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleEnvironmentChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSave (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleCancel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.routes.profile.tests.profile_settings_state_integration (
Module)- 📝 Verifies profile settings preload, cancel without persistence, and saved-state reload behavior.
- 🏗️ Layer: UI (Tests)
- 📦 frontend.src.routes.profile.tests.profile_preferences_integration (
Module)- 📝 Verifies profile binding happy path and degraded lookup manual fallback save flow.
- 🏗️ Layer: UI (Tests)
- 📦 frontend.src.routes.profile.tests.fixtures.profile_fixtures (
Module)[TRIVIAL]- 📝 Shared fixture placeholders for profile page integration tests.
- 🧩 StoragePage (
Component)- 📝 Main page for unified file storage management.
- 🏗️ Layer: UI
- 🔒 Invariant: Always displays a unified storage view without category tabs.
- ⬅️ READS_FROM
app - ➡️ WRITES_TO
state - ⬅️ READS_FROM
t - 🔗 DEPENDS_ON ->
storageService - ƒ loadFiles (
Function)[TRIVIAL]- 📝 Fetches the list of files from the server.
- ƒ resolveStorageQueryFromPath (
Function)[TRIVIAL]- 📝 Splits UI path into storage API category and category-local subpath.
- ƒ handleDelete (
Function)[TRIVIAL]- 📝 Handles the file deletion process.
- ƒ handleNavigate (
Function)[TRIVIAL]- 📝 Updates the current path and reloads files when navigating into a directory.
- ƒ navigateUp (
Function)[TRIVIAL]- 📝 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]- 📝 Page for the dataset column mapper tool.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
t
- 🧩 DebugPage (
Component)[TRIVIAL]- 📝 Page for system diagnostics and debugging.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
t
- 📦 SettingsPage (
Page)[CRITICAL]- 📝 Consolidated Settings Page - All settings in one place with tabbed navigation
- 🏗️ Layer: UI
- 🔒 Invariant: Always shows tabbed interface with all settings categories
- 🔗 BINDS_TO ->
sidebarStore
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/settings/+page.svelte
- 🏗️ Layer: Unknown
- ƒ createEmptyConnectionDraft (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeTab (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ readTabFromUrl (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ writeTabToUrl (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadSettings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeLlmSettings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ isMultimodalModel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getProviderById (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ isDashboardValidationBindingValid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleTabChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadConnections (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resetConnectionForm (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openConnectionForm (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ closeConnectionForm (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleCreateConnection (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleDeleteConnection (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadMigrationSettings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadMappingsPage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ onMappingsSearchInput (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ onMappingsFilterChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ goToMappingsPage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ saveMigrationSettings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ triggerSyncNow (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleRefresh (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSave (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleTestEnv (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ editEnv (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resetEnvForm (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleAddOrUpdateEnv (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleDeleteEnv (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolveEnvStage (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeSupersetBaseUrl (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ load (
Function)[TRIVIAL]- 📝 Loads application settings and environment list.
- 🧩 NotificationSettingsPage (
Component)- 📝 Manage global notification provider configurations (SMTP, Telegram, Slack).
- 🏗️ Layer: UI
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - ⬅️ READS_FROM
t
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/settings/notifications/+page.svelte
- 🏗️ Layer: Unknown
- ƒ loadConfig (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSave (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 ConnectionsSettingsPage (
Component)[TRIVIAL]- 📝 Page for managing database connection configurations.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
t - ƒ handleSuccess (
Function)[TRIVIAL]- 📝 Refreshes the connection list after a successful creation.
- 🧩 GitSettingsPage (
Component)[TRIVIAL]- 📝 Manage Git server configurations for dashboard versioning.
- 🏗️ Layer: Page
- 🔒 Invariant: All configurations must be validated via connection test.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - ⬅️ READS_FROM
t - ƒ loadConfigs (
Function)[TRIVIAL]- 📝 Fetches existing git configurations.
- ƒ handleTest (
Function)[TRIVIAL]- 📝 Tests connection to a git server with current form data.
- ƒ handleSave (
Function)[TRIVIAL]- 📝 Saves a new git configuration.
- ƒ handleEdit (
Function)[TRIVIAL]- 📝 Populates the form with an existing config to edit.
- ƒ resetForm (
Function)[TRIVIAL]- 📝 Resets the configuration form.
- ƒ handleDelete (
Function)[TRIVIAL]- 📝 Deletes a git configuration by ID.
- ƒ loadGiteaRepos (
Function)[TRIVIAL]- 📝 Loads repositories from selected Gitea config.
- ƒ handleCreateGiteaRepo (
Function)[TRIVIAL]- 📝 Creates new repository on selected Gitea server.
- ƒ handleDeleteGiteaRepo (
Function)[TRIVIAL]- 📝 Deletes repository from selected Gitea server.
- 📦 frontend.src.routes.settings.git.tests.git_settings_page_ux_test (
Module)[TRIVIAL]- 📝 Test UX states and transitions for the Git Settings page
- 🧩 AutomationSettingsPage (
Component)- 📝 Settings page for managing validation policies.
- 🏗️ Layer: UI/Page
- ⬅️ READS_FROM
state - ⬅️ READS_FROM
derived - ⬅️ READS_FROM
lib
- 📦 +page (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/routes/settings/automation/+page.svelte
- 🏗️ Layer: Unknown
- ƒ loadData (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleAdd (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleEdit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSave (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleDelete (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getEnvName (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 GitDashboardPage (
Component)[TRIVIAL]- 📝 Dashboard management page for Git integration.
- 🏗️ Layer: Page
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
state - ➡️ WRITES_TO
derived - ƒ fetchEnvironments (
Function)[TRIVIAL]- 📝 Fetches the list of deployment environments from the API.
- ƒ fetchDashboards (
Function)[TRIVIAL]- 📝 Fetches dashboards for a specific environment.
- 🧩 Dashboard (
Component)[TRIVIAL]- 📝 Displays the list of available plugins and allows selecting one.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
plugins - 🔗 DEPENDS_ON ->
frontend/src/lib/stores.js - ƒ onMount (
Function)[TRIVIAL]- 📝 Fetch plugins when the component mounts.
- ƒ selectPlugin (
Function)[TRIVIAL]- 📝 Selects a plugin to display its form.
- 🧩 Settings (
Component)[TRIVIAL]- 📝 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 - 🔗 CALLS ->
api.js - ƒ loadSettings (
Function)[TRIVIAL]- 📝 Loads settings from the backend.
- ƒ handleSaveGlobal (
Function)[TRIVIAL]- 📝 Saves global settings to the backend.
- ƒ handleAddOrUpdateEnv (
Function)[TRIVIAL]- 📝 Adds or updates an environment.
- ƒ handleDeleteEnv (
Function)[TRIVIAL]- 📝 Deletes an environment.
- ƒ handleTestEnv (
Function)[TRIVIAL]- 📝 Tests the connection to an environment.
- ƒ editEnv (
Function)[TRIVIAL]- 📝 Sets the form to edit an existing environment.
- ƒ resetEnvForm (
Function)[TRIVIAL]- 📝 Resets the environment form.
- ƒ getConnections (
Function)[TRIVIAL]- 📝 Fetch a list of saved connections.
- ƒ createConnection (
Function)[TRIVIAL]- 📝 Create a new connection configuration.
- ƒ deleteConnection (
Function)[TRIVIAL]- 📝 Delete a connection configuration.
- 📦 GitServiceClient (
Module)- 📝 API client for Git operations, managing the communication between frontend and backend.
- 🏗️ Layer: Service
- 🔗 DEPENDS_ON ->
specs/011-git-integration-dashboard/contracts/api.md - 📦 gitService (
Action)[TRIVIAL]- 📝 Promotes changes between branches via MR or direct merge.
- ƒ buildDashboardRepoEndpoint (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ runTask (
Function)[TRIVIAL]- 📝 Start a new task for a given plugin.
- ƒ getTaskStatus (
Function)[TRIVIAL]- 📝 Fetch details for a specific task (to poll status or get result).
- 📦 adminService (
Module)- 📝 Service for Admin-related API calls (User and Role management).
- 🏗️ Layer: Service
- 🔒 Invariant: All requests must include valid Admin JWT token (handled by api client).
- 🔗 DEPENDS_ON ->
frontend.src.lib.api - ƒ getUsers (
Function)[TRIVIAL]- 📝 Fetches all registered users from the backend.
- ƒ createUser (
Function)[TRIVIAL]- 📝 Creates a new local user.
- ƒ getRoles (
Function)[TRIVIAL]- 📝 Fetches all available system roles.
- ƒ getADGroupMappings (
Function)[TRIVIAL]- 📝 Fetches mappings between AD groups and local roles.
- ƒ createADGroupMapping (
Function)[TRIVIAL]- 📝 Creates or updates an AD group to Role mapping.
- ƒ updateUser (
Function)[TRIVIAL]- 📝 Updates an existing user.
- ƒ deleteUser (
Function)[TRIVIAL]- 📝 Deletes a user.
- ƒ createRole (
Function)[TRIVIAL]- 📝 Creates a new role.
- ƒ updateRole (
Function)[TRIVIAL]- 📝 Updates an existing role.
- ƒ deleteRole (
Function)[TRIVIAL]- 📝 Deletes a role.
- ƒ getPermissions (
Function)[TRIVIAL]- 📝 Fetches all available permissions.
- ƒ getLoggingConfig (
Function)[TRIVIAL]- 📝 Fetches current logging configuration.
- ƒ updateLoggingConfig (
Function)[TRIVIAL]- 📝 Updates logging configuration.
- ƒ getTasks (
Function)[TRIVIAL]- 📝 Fetch a list of tasks with pagination and optional status filter.
- ƒ getTask (
Function)[TRIVIAL]- 📝 Fetch details for a specific task.
- ƒ getTaskLogs (
Function)[TRIVIAL]- 📝 Fetch logs for a specific task.
- ƒ resumeTask (
Function)[TRIVIAL]- 📝 Resume a task that is awaiting input (e.g., passwords).
- ƒ resolveTask (
Function)[TRIVIAL]- 📝 Resolve a task that is awaiting mapping.
- ƒ clearTasks (
Function)[TRIVIAL]- 📝 Clear tasks based on status.
- 📦 storageService (
Module)- 📝 Frontend API client for file storage management.
- 🏗️ Layer: Service
- ƒ getStorageAuthHeaders (
Function)[TRIVIAL]- 📝 Returns headers with Authorization for storage API calls.
- ƒ encodeStoragePath (
Function)[TRIVIAL]- 📝 Encodes a storage-relative path preserving slash separators.
- ƒ listFiles (
Function)[TRIVIAL]- 📝 Fetches the list of files for a given category and subpath.
- ƒ uploadFile (
Function)[TRIVIAL]- 📝 Uploads a file to the storage system.
- ƒ deleteFile (
Function)[TRIVIAL]- 📝 Deletes a file or directory from storage.
- ƒ downloadFileUrl (
Function)[TRIVIAL]- 📝 Returns the URL for downloading a file.
- ƒ downloadFile (
Function)[TRIVIAL]- 📝 Downloads a file using authenticated fetch and saves it in browser.
- 📦 frontend.src.services.tests.gitService_test (
Module)[TRIVIAL]- 📝 API client tests ensuring correct endpoints are called per contract
- 🧩 DashboardGrid (
Component)- 📝 Displays a grid of dashboards with selection and pagination.
- 🏗️ Layer: Component
- 🔒 Invariant: Selected IDs must be a subset of available dashboards.
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ➡️ WRITES_TO
derived - ƒ handleSort (
Function)[TRIVIAL]- 📝 Toggles sort direction or changes sort column.
- ƒ handleSelectionChange (
Function)[TRIVIAL]- 📝 Handles individual checkbox changes.
- ƒ handleSelectAll (
Function)[TRIVIAL]- 📝 Handles select all checkbox.
- ƒ goToPage (
Function)[TRIVIAL]- 📝 Changes current page.
- ƒ getRepositoryStatusToken (
Function)[TRIVIAL]- 📝 Returns normalized repository status token for a dashboard.
- ƒ isRepositoryReady (
Function)[TRIVIAL]- 📝 Determines whether git actions can run for a dashboard.
- ƒ invalidateRepositoryStatuses (
Function)[TRIVIAL]- 📝 Marks dashboard statuses as loading so they are refetched.
- ƒ resolveRepositoryStatusToken (
Function)[TRIVIAL]- 📝 Converts git status payload into a stable UI status token.
- ƒ loadRepositoryStatuses (
Function)[TRIVIAL]- 📝 Hydrates repository status map for dashboards in repository mode.
- ƒ runBulkGitAction (
Function)[TRIVIAL]- 📝 Executes git action for selected dashboards with limited parallelism.
- ƒ handleBulkSync (
Function)[TRIVIAL] - ƒ handleBulkCommit (
Function)[TRIVIAL] - ƒ handleBulkPull (
Function)[TRIVIAL] - ƒ handleBulkPush (
Function)[TRIVIAL] - ƒ handleBulkDelete (
Function)[TRIVIAL]- 📝 Removes selected repositories from storage and binding table.
- ƒ handleManageSelected (
Function)[TRIVIAL]- 📝 Opens Git manager for exactly one selected dashboard.
- ƒ resolveDashboardRef (
Function)[TRIVIAL]- 📝 Resolves dashboard slug from payload fields.
- ƒ openGitManagerForDashboard (
Function)[TRIVIAL]- 📝 Opens Git manager for provided dashboard metadata.
- ƒ handleInitializeRepositories (
Function)[TRIVIAL]- 📝 Opens Git manager from bulk actions to initialize selected repository.
- ƒ getSortStatusValue (
Function)[TRIVIAL]- 📝 Returns sort value for status column based on mode.
- ƒ getStatusLabel (
Function)[TRIVIAL]- 📝 Returns localized label for status column.
- ƒ getStatusBadgeClass (
Function)[TRIVIAL]- 📝 Returns badge style for status column.
- 🧩 PasswordPrompt (
Component)[TRIVIAL]- 📝 A modal component to prompt the user for database passwords when a migration task is paused.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ⬅️ READS_FROM
effect - 🔗 BINDS_TO ->
onresume - 🔗 BINDS_TO ->
oncancel - ƒ handleSubmit (
Function)[TRIVIAL]- 📝 Validates and forwards passwords to resume the task.
- ƒ handleCancel (
Function)[TRIVIAL]- 📝 Cancels the password prompt.
- 🧩 MappingTable (
Component)[TRIVIAL]- 📝 Displays and allows editing of database mappings.
- 🏗️ Layer: Feature
- 🔒 Invariant: Each source database can be mapped to one target database.
- ⬅️ READS_FROM
lib - ➡️ WRITES_TO
props - ➡️ WRITES_TO
t - 🔗 BINDS_TO ->
mappings state - ƒ updateMapping (
Function)[TRIVIAL]- 📝 Updates a mapping for a specific source database.
- ƒ getSuggestion (
Function)[TRIVIAL]- 📝 Finds a suggestion for a source database.
- 🧩 TaskLogViewer (
Component)- 📝 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.
- ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - 📦 handleRealTimeLogs (
Action)[TRIVIAL]- 📝 Sync real-time logs to the current log list
- ƒ fetchLogs (
Function)[TRIVIAL]- 📝 Fetches logs for a given task ID
- ƒ handleFilterChange (
Function)[TRIVIAL]- 📝 Updates filter conditions for the log viewer
- ƒ handleRefresh (
Function)[TRIVIAL]- 📝 Refreshes the logs by polling the API
- 🧩 showInline (
Component)[TRIVIAL]- 📝 Shows inline logs -->
- 🏗️ Layer: UI -->
- 🧩 showModal (
Component)[TRIVIAL]- 📝 Shows modal logs -->
- 🏗️ Layer: UI -->
- 🧩 Footer (
Component)[TRIVIAL]- 📝 Displays the application footer with copyright information.
- 🏗️ Layer: UI
- 🧩 MissingMappingModal (
Component)[TRIVIAL]- 📝 Prompts the user to provide a database mapping when one is missing during migration.
- 🏗️ Layer: Feature
- 🔒 Invariant: Modal blocks migration progress until resolved or cancelled.
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - 🔗 BINDS_TO ->
onresolve - 🔗 BINDS_TO ->
oncancel - ƒ resolve (
Function)[TRIVIAL]- 📝 Resolves the missing mapping via callback prop.
- ƒ cancel (
Function)[TRIVIAL]- 📝 Cancels the mapping resolution modal.
- 🧩 DashboardGrid (
Component)- 📝 Displays a grid of dashboards with selection and pagination.
- 🏗️ Layer: Component
- 🔒 Invariant: Selected IDs must be a subset of available dashboards.
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ➡️ WRITES_TO
derived - ƒ handleValidate (
Function)[TRIVIAL]- 📝 Triggers dashboard validation task.
- ƒ handleSort (
Function)[TRIVIAL]- 📝 Toggles sort direction or changes sort column.
- ƒ handleSelectionChange (
Function)[TRIVIAL]- 📝 Handles individual checkbox changes.
- ƒ handleSelectAll (
Function)[TRIVIAL]- 📝 Handles select all checkbox.
- ƒ goToPage (
Function)[TRIVIAL]- 📝 Changes current page.
- ƒ openGit (
Function)[TRIVIAL]- 📝 Opens the Git management modal for a dashboard.
- 🧩 Navbar (
Component)- 📝 Main navigation bar for the application.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
app - ⬅️ READS_FROM
lib - ⬅️ READS_FROM
t
- 📦 Navbar (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/Navbar.svelte
- 🏗️ Layer: Unknown
- ƒ handleLogout (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 TaskHistory (
Component)[TRIVIAL]- 📝 Displays a list of recent tasks with their status and allows selecting them for viewing logs.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
selectedTask - ➡️ WRITES_TO
selectedTask - ⬅️ READS_FROM
t - ƒ fetchTasks (
Function)[TRIVIAL]- 📝 Fetches the list of recent tasks from the API.
- ƒ clearTasks (
Function)[TRIVIAL]- 📝 Clears tasks from the history, optionally filtered by status.
- ƒ selectTask (
Function)[TRIVIAL]- 📝 Selects a task and fetches its full details.
- ƒ getStatusColor (
Function)[TRIVIAL]- 📝 Returns the CSS color class for a given task status.
- ƒ onMount (
Function)[TRIVIAL]- 📝 Initializes the component by fetching tasks and starting polling.
- ƒ onDestroy (
Function)[TRIVIAL]- 📝 Cleans up the polling interval when the component is destroyed.
- 🧩 Toast (
Component)[TRIVIAL]- 📝 Displays transient notifications (toasts) in the bottom-right corner.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
toasts - 🔗 DEPENDS_ON ->
frontend/src/lib/toasts.js
- 🧩 TaskRunner (
Component)- 📝 Connects to a WebSocket to display real-time logs for a running task with filtering support.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
t - ⬅️ READS_FROM
selectedTask - ➡️ WRITES_TO
t - 🔗 DEPENDS_ON ->
frontend/src/lib/stores.js, frontend/src/components/tasks/TaskLogPanel.svelte - ƒ connect (
Function)[TRIVIAL]- 📝 Establishes WebSocket connection with exponential backoff and filter parameters.
- ƒ handleFilterChange (
Function)[TRIVIAL]- 📝 Handles filter changes and reconnects WebSocket with new parameters.
- ƒ fetchTargetDatabases (
Function)[TRIVIAL]- 📝 Fetches available databases from target environment for mapping.
- ƒ handleMappingResolve (
Function)[TRIVIAL]- 📝 Resolves missing database mapping and continues migration.
- ƒ handlePasswordResume (
Function)[TRIVIAL]- 📝 Submits passwords and resumes paused migration task.
- ƒ startDataTimeout (
Function)[TRIVIAL]- 📝 Starts timeout timer to detect idle connection.
- ƒ resetDataTimeout (
Function)[TRIVIAL]- 📝 Resets data timeout timer when new data arrives.
- ƒ onMount (
Function)[TRIVIAL]- 📝 Initializes WebSocket connection when component mounts.
- ƒ onDestroy (
Function)[TRIVIAL]
- 🧩 TaskList (
Component)[TRIVIAL]- 📝 Displays a list of tasks with their status and execution details.
- 🏗️ Layer: Component
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
t - ⬅️ READS_FROM
t - ƒ getStatusColor (
Function)[TRIVIAL]- 📝 Returns the CSS color class for a given task status.
- ƒ formatTime (
Function)[TRIVIAL]- 📝 Formats a date string using date-fns.
- ƒ handleTaskClick (
Function)[TRIVIAL]- 📝 Forwards the selected task through a callback prop.
- 🧩 DynamicForm (
Component)[TRIVIAL]- 📝 Generates a form dynamically based on a JSON schema.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - 🔗 BINDS_TO ->
onsubmit callback - ƒ handleSubmit (
Function)[TRIVIAL]- 📝 Emits submitted form data via callback prop.
- ƒ initializeForm (
Function)[TRIVIAL]- 📝 Initialize form data with default values from the schema.
- 🧩 EnvSelector (
Component)[TRIVIAL]- 📝 Provides a UI component for selecting source and target environments.
- 🏗️ Layer: Feature
- 🔒 Invariant: Source and target environments must be selectable from the list of configured environments.
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
t - 🔗 BINDS_TO ->
environments store - ƒ handleSelect (
Function)[TRIVIAL]- 📝 Propagates the selection change through a callback prop.
- 🧩 StartupEnvironmentWizard (
Component)- 📝 Blocking startup wizard for creating the first Superset environment from zero-state screens.
- 🏗️ Layer: UI
- 🔒 Invariant: When open, wizard keeps user on an actionable setup path until the first environment exists.
- ⬅️ READS_FROM
app - ⬅️ READS_FROM
lib - ➡️ WRITES_TO
props - 🔗 CALLS ->
api.addEnvironment - 🔗 CALLS ->
environmentContext.refreshEnvironmentContext
- 📦 StartupEnvironmentWizard (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/StartupEnvironmentWizard.svelte
- 🏗️ Layer: Unknown
- ƒ createInitialForm (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ slugifyEnvironmentId (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ normalizeSupersetBaseUrl (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resetWizard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleNameInput (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleIdInput (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openAdvancedSettings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleCreateEnvironment (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 ProtectedRoute.svelte (
Module)- 📝 Enforces authenticated and authorized access before protected route content is rendered.
- 🏗️ Layer: UI
- 🔒 Invariant: Unauthenticated users are redirected to /login, unauthorized users are redirected to fallbackPath, and protected slot renders only when access is verified.
- 🔗 BINDS_TO ->
frontend.src.lib.auth.store.auth - 🔗 CALLS ->
$app/navigation.goto - 🔗 DEPENDS_ON ->
$lib/auth/permissions.hasPermission - 🔗 CALLS ->
frontend.src.lib.api.api.fetchApi - 🧩 ProtectedRoute (
Component)[TRIVIAL]- 📝 Wraps protected slot content with session and permission verification guards.
- ƒ verifySessionAndAccess (
Function)[TRIVIAL]- 📝 Validates session and optional permission gate before allowing protected content render.
- 🧩 TaskLogPanel (
Component)- 📝 Combines log filtering and display into a single cohesive dark-themed panel.
- 🏗️ Layer: UI
- 🔒 Invariant: Must always display logs in chronological order and respect auto-scroll preference.
- ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props - ➡️ WRITES_TO
state
- 📦 TaskLogPanel (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/tasks/TaskLogPanel.svelte
- 🏗️ Layer: Unknown
- ƒ filterLogs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleFilterChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ scrollToBottom (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleAutoScroll (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 LogFilterBar (
Component)- 📝 Compact filter toolbar for logs — level, source, and text search in a single dense row.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props - ➡️ WRITES_TO
derived
- 📦 LogFilterBar (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/tasks/LogFilterBar.svelte
- 🏗️ Layer: Unknown
- ƒ handleLevelChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSourceChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSearchChange (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ clearFilters (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 LogEntryRow (
Component)- 📝 Renders a single log entry with stacked layout optimized for narrow drawer panels.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
derived - ƒ formatTime (
Function)[TRIVIAL]- 📝 Format ISO timestamp to HH:MM:SS */
- 📦 TaskResultPanel (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/tasks/TaskResultPanel.svelte
- 🏗️ Layer: Unknown
- ƒ statusColor (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.components.tests.task_log_viewer (
Module)- 📝 Unit tests for TaskLogViewer component by mounting it and observing the DOM.
- 🏗️ Layer: UI (Tests)
- 🔒 Invariant: Duplicate logs are never appended. Polling only active for in-progress tasks.
- 🧩 FileList (
Component)- 📝 Displays a table of files with metadata and actions.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
t - ⬅️ READS_FROM
t - 🔗 DEPENDS_ON ->
storageService - ƒ isDirectory (
Function)[TRIVIAL]- 📝 Checks if a file object represents a directory.
- ƒ formatSize (
Function)[TRIVIAL]- 📝 Formats file size in bytes into a human-readable string.
- ƒ formatDate (
Function)[TRIVIAL]- 📝 Formats an ISO date string into a localized readable format.
- ƒ handleDownload (
Function)[TRIVIAL]- 📝 Downloads selected file through authenticated API request.
- 🧩 FileUpload (
Component)- 📝 Provides a form for uploading files to a specific category.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ⬅️ READS_FROM
t - 🔗 DEPENDS_ON ->
storageService - ƒ handleUpload (
Function)[TRIVIAL]- 📝 Handles the file upload process.
- ƒ handleDrop (
Function)[TRIVIAL]- 📝 Handles the file drop event for drag-and-drop.
- 🧩 ConnectionForm (
Component)[TRIVIAL]- 📝 UI component for creating a new database connection configuration.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ⬅️ READS_FROM
t - ƒ handleSubmit (
Function)[TRIVIAL]- 📝 Submits the connection form to the backend.
- ƒ resetForm (
Function)[TRIVIAL]- 📝 Resets the connection form fields to their default values.
- 🧩 ConnectionList (
Component)[TRIVIAL]- 📝 UI component for listing and deleting saved database connection configurations.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
state - ⬅️ READS_FROM
t - ➡️ WRITES_TO
t - ƒ fetchConnections (
Function)[TRIVIAL]- 📝 Fetches the list of connections from the backend.
- ƒ handleDelete (
Function)[TRIVIAL]- 📝 Deletes a connection configuration.
- 🧩 MapperTool (
Component)[TRIVIAL]- 📝 UI component for mapping dataset column verbose names using the MapperPlugin.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
t - ➡️ WRITES_TO
t - ƒ fetchData (
Function)[TRIVIAL]- 📝 Fetches environments and saved connections.
- ƒ handleRunMapper (
Function)[TRIVIAL]- 📝 Triggers the MapperPlugin task.
- ƒ handleGenerateDocs (
Function)[TRIVIAL]- 📝 Triggers the LLM Documentation task.
- 📦 MapperTool (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/tools/MapperTool.svelte
- 🏗️ Layer: Unknown
- ƒ handleApplyDoc (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 DebugTool (
Component)[TRIVIAL]- 📝 UI component for system diagnostics and debugging API responses.
- 🏗️ Layer: UI
- ⬅️ READS_FROM
t - ➡️ WRITES_TO
t - ƒ fetchEnvironments (
Function)[TRIVIAL]- 📝 Fetches available environments.
- ƒ handleRunDebug (
Function)[TRIVIAL]- 📝 Triggers the debug task.
- ƒ startPolling (
Function)[TRIVIAL]- 📝 Polls for task completion.
- 🧩 CommitHistory (
Component)[TRIVIAL]- 📝 Displays the commit history for a specific dashboard.
- 🏗️ Layer: Component
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ⬅️ READS_FROM
t - 🔗 CALLS ->
gitService.getHistory - ƒ onMount (
Function)[TRIVIAL]- 📝 Load history when component is mounted.
- ƒ loadHistory (
Function)[TRIVIAL]- 📝 Fetch commit history from the backend.
- 🧩 DeploymentModal (
Component)[TRIVIAL]- 📝 Modal for deploying a dashboard to a target environment.
- 🏗️ Layer: Component
- 🔒 Invariant: Cannot deploy without a selected environment.
- ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - 🔗 CALLS ->
frontend/src/services/gitService.js - 🔗 DISPATCHES ->
deploy - 📦 loadStatus (
Watcher)[TRIVIAL] - ƒ normalizeEnvStage (
Function)[TRIVIAL]- 📝 Normalize environment stage with legacy production fallback.
- ƒ resolveEnvUrl (
Function)[TRIVIAL]- 📝 Resolve environment URL from consolidated or git-specific payload shape.
- ƒ loadEnvironments (
Function)[TRIVIAL]- 📝 Fetch available environments from API.
- ƒ handleDeploy (
Function)[TRIVIAL]- 📝 Trigger deployment to selected environment.
- 🧩 ConflictResolver (
Component)[TRIVIAL]- 📝 UI for resolving merge conflicts (Keep Mine / Keep Theirs).
- 🏗️ Layer: Component
- 🔒 Invariant: User must resolve all conflicts before saving.
- ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - 🔗 BINDS_TO ->
onresolve - ƒ resolve (
Function)[TRIVIAL]- 📝 Set resolution strategy for a file.
- ƒ handleSave (
Function)[TRIVIAL]- 📝 Validate and submit resolutions.
- 🧩 CommitModal (
Component)- 📝 Модальное окно для создания коммита с просмотром изменений (diff).
- 🏗️ Layer: Component
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ⬅️ READS_FROM
t - 🔗 CALLS ->
gitService.commit - 🔗 CALLS ->
gitService.getStatus - 🔗 CALLS ->
gitService.getDiff - 🔗 DISPATCHES ->
commit - ƒ handleGenerateMessage (
Function)[TRIVIAL]- 📝 Generates a commit message using LLM.
- ƒ loadStatus (
Function)[TRIVIAL]- 📝 Загружает текущий статус репозитория и diff.
- ƒ handleCommit (
Function)[TRIVIAL]- 📝 Создает коммит с указанным сообщением.
- 🧩 BranchSelector (
Component)[TRIVIAL]- 📝 UI для выбора и создания веток Git.
- 🏗️ Layer: Component
- ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - 🔗 CALLS ->
gitService.getBranches - 🔗 CALLS ->
gitService.checkoutBranch - 🔗 CALLS ->
gitService.createBranch - 🔗 BINDS_TO ->
onchange - ƒ onMount (
Function)[TRIVIAL]- 📝 Load branches when component is mounted.
- ƒ loadBranches (
Function)[TRIVIAL]- 📝 Загружает список веток для дашборда.
- ƒ handleSelect (
Function)[TRIVIAL]- 📝 Handles branch selection from dropdown.
- ƒ handleCheckout (
Function)[TRIVIAL]- 📝 Переключает текущую ветку.
- ƒ handleCreate (
Function)[TRIVIAL]- 📝 Создает новую ветку.
- 🧩 GitManager (
Component)[TRIVIAL]- 📝 Центральный UI управления Git с фокусом на рабочий поток аналитика (commit -> promote -> deploy).
- 🏗️ Layer: Component
- ➡️ WRITES_TO
bindable - ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - 🔗 CALLS ->
gitService - ƒ normalizeEnvStage (
Function)[TRIVIAL]- 📝 Normalize environment stage with legacy fallback.
- ƒ stageBadgeClass (
Function)[TRIVIAL]- 📝 Return visual class for environment stage badges.
- ƒ resolveCurrentEnvironmentId (
Function)[TRIVIAL]- 📝 Resolve active environment id for current dashboard session.
- ƒ applyGitflowStageDefaults (
Function)[TRIVIAL]- 📝 Apply GitFlow defaults by current environment stage.
- ƒ loadCurrentEnvironmentStage (
Function)[TRIVIAL]- 📝 Detect current environment stage and bind GitFlow defaults.
- ƒ isNumericDashboardRef (
Function)[TRIVIAL]- 📝 Checks whether current dashboard reference is numeric ID.
- ƒ checkStatus (
Function)[TRIVIAL]- 📝 Verify repository initialization for dashboard slug.
- ƒ loadWorkspace (
Function)[TRIVIAL]- 📝 Load current git status and combined diff for workspace tab.
- ƒ handleSync (
Function)[TRIVIAL]- 📝 Sync latest dashboard config from Superset to git workspace.
- ƒ handleGenerateMessage (
Function)[TRIVIAL]- 📝 Generate commit message from diff using LLM.
- ƒ handleCommit (
Function)[TRIVIAL]- 📝 Commit current workspace changes with provided message.
- ƒ handlePull (
Function)[TRIVIAL]- 📝 Pull remote changes for current branch.
- ƒ handlePush (
Function)[TRIVIAL]- 📝 Push local commits to remote repository.
- ƒ handlePromote (
Function)[TRIVIAL]- 📝 Promote branch to the next stage via MR or unsafe direct mode.
- ƒ openDeployModal (
Function)[TRIVIAL]- 📝 Open deploy modal with extra confirmation for PROD context.
- ƒ getSelectedConfig (
Function)[TRIVIAL]- 📝 Return currently selected git server config.
- ƒ resolveDefaultConfig (
Function)[TRIVIAL]- 📝 Resolve default git config for current session.
- ƒ resolvePushProviderLabel (
Function)[TRIVIAL]- 📝 Resolve lower-case provider label for auto-push checkbox.
- ƒ extractHttpHost (
Function)[TRIVIAL]- 📝 Extract comparable host[:port] from URL string.
- ƒ buildSuggestedRepoName (
Function)[TRIVIAL]- 📝 Build deterministic repository name from dashboard title/id.
- ƒ handleCreateRemoteRepo (
Function)[TRIVIAL]- 📝 Create remote repository on selected Git provider.
- ƒ handleInit (
Function)[TRIVIAL]- 📝 Initialize git repository for dashboard.
- ƒ closeModal (
Function)[TRIVIAL]- 📝 Close git manager modal.
- ƒ handleBackdropClick (
Function)[TRIVIAL]- 📝 Close modal on backdrop click.
- 📦 GitManager (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/git/GitManager.svelte
- 🏗️ Layer: Unknown
- ƒ tryParseJsonObject (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ extractUnfinishedMergeContext (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ openUnfinishedMergeDialogFromError (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loadMergeRecoveryState (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ closeUnfinishedMergeDialog (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleOpenConflictResolver (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleResolveConflicts (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleAbortUnfinishedMerge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleContinueUnfinishedMerge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ getUnfinishedMergeCommandsText (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleCopyUnfinishedMergeCommands (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.components.git.tests.git_manager_unfinished_merge_integration (
Module)- 📝 Protect unresolved-merge dialog contract in GitManager pull flow.
- 🏗️ Layer: UI Tests
- 🧩 DocPreview (
Component)- 📝 UI component for previewing generated dataset documentation before saving.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
derived - ➡️ WRITES_TO
state - 🔗 DEPENDS_ON ->
backend/src/plugins/llm_analysis/plugin.py
- 📦 DocPreview (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/llm/DocPreview.svelte
- 🏗️ Layer: Unknown
- ƒ handleSave (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 🧩 ProviderConfig (
Component)- 📝 UI form for managing LLM provider configurations.
- 🏗️ Layer: UI
- ➡️ WRITES_TO
props - ➡️ WRITES_TO
state - ➡️ WRITES_TO
t - 🔗 DEPENDS_ON ->
backend/src/api/routes/llm.py
- 📦 ProviderConfig (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/llm/ProviderConfig.svelte
- 🏗️ Layer: Unknown
- ƒ isMultimodalModel (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resetForm (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleEdit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ testConnection (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleSubmit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ toggleActive (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ handleDelete (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 ValidationReport (
Module)[TRIVIAL]- 📝 Auto-generated module for frontend/src/components/llm/ValidationReport.svelte
- 🏗️ Layer: Unknown
- ƒ getStatusColor (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 frontend.src.components.llm.tests.provider_config_integration (
Module)- 📝 Protect edit and delete interaction contracts in LLM provider settings UI.
- 🏗️ Layer: UI Tests
- 🔒 Invariant: Edit action keeps explicit click handler and opens normalized edit form.
- ƒ provider_config_edit_contract_tests (
Function)- 📝 Validate edit and delete handler wiring plus normalized edit form state mapping.
- 📦 backend.delete_running_tasks (
Module)[TRIVIAL]- 📝 Script to delete tasks with RUNNING status from the database.
- 🏗️ Layer: Utility
- ƒ delete_running_tasks (
Function)[TRIVIAL]- 📝 Delete all tasks with RUNNING status from the database.
- 📦 AppModule (
Module)[CRITICAL]- 📝 The main entry point for the FastAPI application. It initializes the app, configures CORS, sets up dependencies, includes API routers, and defines the WebSocket endpoint for log streaming.
- 🏗️ Layer: UI (API)
- 🔒 Invariant: All WebSocket connections must be properly cleaned up on disconnect.
- 🔗 DEPENDS_ON ->
backend.src.dependencies - 🔗 DEPENDS_ON ->
backend.src.api.routes - 📦 App (
Global)[TRIVIAL]- 📝 The global FastAPI application instance.
- ƒ startup_event (
Function)- 📝 Handles application startup tasks, such as starting the scheduler.
- ƒ shutdown_event (
Function)- 📝 Handles application shutdown tasks, such as stopping the scheduler.
- ƒ network_error_handler (
Function)[TRIVIAL]- 📝 Global exception handler for NetworkError.
- ƒ log_requests (
Function)- 📝 Middleware to log incoming HTTP requests and their response status.
- 📦 api.include_routers (
Action)[TRIVIAL]- 📝 Registers all API routers with the FastAPI application.
- 🏗️ Layer: API
- ƒ websocket_endpoint (
Function)[CRITICAL]- 📝 Provides a WebSocket endpoint for real-time log streaming of a task with server-side filtering.
- 📦 StaticFiles (
Mount)[TRIVIAL]- 📝 Mounts the frontend build directory to serve static assets.
- ƒ serve_spa (
Function)[TRIVIAL]- 📝 Serves the SPA frontend for any path not matched by API routes.
- ƒ read_root (
Function)[TRIVIAL]- 📝 A simple root endpoint to confirm that the API is running when frontend is missing.
- ƒ matches_filters (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.dependencies (
Module)- 📝 Manages creation and provision of shared application dependencies, such as PluginLoader and TaskManager, to avoid circular imports.
- 🏗️ Layer: Core
- ƒ get_config_manager (
Function)[TRIVIAL]- 📝 Dependency injector for ConfigManager.
- ƒ get_plugin_loader (
Function)[TRIVIAL]- 📝 Dependency injector for PluginLoader.
- ƒ get_task_manager (
Function)[TRIVIAL]- 📝 Dependency injector for TaskManager.
- ƒ get_scheduler_service (
Function)[TRIVIAL]- 📝 Dependency injector for SchedulerService.
- ƒ get_resource_service (
Function)[TRIVIAL]- 📝 Dependency injector for ResourceService.
- ƒ get_mapping_service (
Function)[TRIVIAL]- 📝 Dependency injector for MappingService.
- ƒ get_clean_release_repository (
Function)[TRIVIAL]- 📝 Legacy compatibility shim for CleanReleaseRepository.
- ƒ get_clean_release_facade (
Function)[TRIVIAL]- 📝 Dependency injector for CleanReleaseFacade.
- 📦 oauth2_scheme (
Variable)[TRIVIAL]- 📝 OAuth2 password bearer scheme for token extraction.
- ƒ get_current_user (
Function)- 📝 Dependency for retrieving currently authenticated user from a JWT.
- ƒ has_permission (
Function)- 📝 Dependency for checking if the current user has a specific permission.
- ƒ permission_checker (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 src (
Package)[TRIVIAL]- 📝 Canonical backend package root for application, scripts, and tests.
- 📦 backend.src.scripts.seed_superset_load_test (
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.
- ƒ _parse_args (
Function)[TRIVIAL]- 📝 Parses CLI arguments for load-test data generation.
- ƒ _extract_result_payload (
Function)[TRIVIAL]- 📝 Normalizes Superset API payloads that may be wrapped in
result.
- 📝 Normalizes Superset API payloads that may be wrapped in
- ƒ _extract_created_id (
Function)[TRIVIAL]- 📝 Extracts object ID from create/update API response.
- ƒ _generate_unique_name (
Function)[TRIVIAL]- 📝 Generates globally unique random names for charts/dashboards.
- ƒ _resolve_target_envs (
Function)[TRIVIAL]- 📝 Resolves requested environment IDs from configuration.
- ƒ _build_chart_template_pool (
Function)[TRIVIAL]- 📝 Builds a pool of source chart templates to clone in one environment.
- ƒ seed_superset_load_data (
Function)[TRIVIAL]- 📝 Creates dashboards and cloned charts for load testing across target environments.
- ƒ main (
Function)[TRIVIAL]- 📝 CLI entrypoint for Superset load-test data seeding.
- 📦 test_dataset_dashboard_relations (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/scripts/test_dataset_dashboard_relations.py
- 🏗️ Layer: Unknown
- ƒ test_dashboard_dataset_relations (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.scripts.clean_release_tui (
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 - ℂ TuiFacadeAdapter (
Class)[TRIVIAL]- 📝 Thin TUI adapter that routes business mutations through application services.
- ℂ CleanReleaseTUI (
Class)[TRIVIAL]- 📝 Curses-based application for compliance monitoring.
- ƒ run_checks (
Function)[TRIVIAL]- 📝 Execute compliance run via facade adapter and update UI state.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _build_config_manager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ run_compliance (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ approve_latest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ publish_latest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ build_manifest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_overview (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _build_repository (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _bootstrap_demo_repository (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _bootstrap_real_repository (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _resolve_candidate_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ draw_header (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ draw_checks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ draw_sources (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ draw_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ draw_footer (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ build_manifest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ clear_history (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ approve_latest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ publish_latest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refresh_overview (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refresh_overview (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refresh_screen (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ loop (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ tui_main (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ main (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.scripts.migrate_sqlite_to_postgres (
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.
- 📦 Constants (
Section)[TRIVIAL] - ƒ _json_load_if_needed (
Function)- 📝 Parses JSON-like values from SQLite TEXT/JSON columns to Python objects.
- ƒ _find_legacy_config_path (
Function)[TRIVIAL]- 📝 Resolves the existing legacy config.json path from candidates.
- ƒ _connect_sqlite (
Function)[TRIVIAL]- 📝 Opens a SQLite connection with row factory.
- ƒ _ensure_target_schema (
Function)[TRIVIAL]- 📝 Ensures required PostgreSQL tables exist before migration.
- ƒ _migrate_config (
Function)[TRIVIAL]- 📝 Migrates legacy config.json into app_configurations(global).
- ƒ _migrate_tasks_and_logs (
Function)[TRIVIAL]- 📝 Migrates task_records and task_logs from SQLite into PostgreSQL.
- ƒ run_migration (
Function)[TRIVIAL]- 📝 Orchestrates migration from SQLite/file to PostgreSQL.
- ƒ main (
Function)[TRIVIAL]- 📝 CLI entrypoint.
- 📦 backend.src.scripts.clean_release_cli (
Module)- 📝 Provide headless CLI commands for candidate registration, artifact import and manifest build.
- 🏗️ Layer: Scripts
- ƒ build_parser (
Function)[TRIVIAL]- 📝 Build argparse parser for clean release CLI.
- ƒ run_candidate_register (
Function)[TRIVIAL]- 📝 Register candidate in repository via CLI command.
- ƒ run_artifact_import (
Function)[TRIVIAL]- 📝 Import single artifact for existing candidate.
- ƒ run_manifest_build (
Function)[TRIVIAL]- 📝 Build immutable manifest snapshot for candidate.
- ƒ run_compliance_run (
Function)[TRIVIAL]- 📝 Execute compliance run for candidate with optional manifest fallback.
- ƒ run_compliance_status (
Function)[TRIVIAL]- 📝 Read run status by run id.
- ƒ _to_payload (
Function)[TRIVIAL]- 📝 Serialize domain models for CLI JSON output across SQLAlchemy/Pydantic variants.
- ƒ run_compliance_report (
Function)[TRIVIAL]- 📝 Read immutable report by run id.
- ƒ run_compliance_violations (
Function)[TRIVIAL]- 📝 Read run violations by run id.
- ƒ run_approve (
Function)[TRIVIAL]- 📝 Approve candidate based on immutable PASSED report.
- ƒ run_reject (
Function)[TRIVIAL]- 📝 Reject candidate without mutating compliance evidence.
- ƒ run_publish (
Function)[TRIVIAL]- 📝 Publish approved candidate to target channel.
- ƒ run_revoke (
Function)[TRIVIAL]- 📝 Revoke active publication record.
- ƒ main (
Function)[TRIVIAL]- 📝 CLI entrypoint for clean release commands.
- ƒ _normalize (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.scripts.seed_permissions (
Module)[TRIVIAL]- 📝 Populates the auth database with initial system permissions.
- 🏗️ Layer: Scripts
- 🔒 Invariant: Safe to run multiple times (idempotent).
- 📦 INITIAL_PERMISSIONS (
Constant)[TRIVIAL] - ƒ seed_permissions (
Function)[TRIVIAL]- 📝 Inserts missing permissions into the database.
- 📦 backend.src.scripts.init_auth_db (
Module)[CRITICAL]- 📝 Initializes the auth database and creates the necessary tables.
- 🏗️ Layer: Scripts
- 🔒 Invariant: Safe to run multiple times (idempotent).
- 🔗 CALLS ->
backend.src.core.database.init_db - ƒ run_init (
Function)[TRIVIAL]- 📝 Main entry point for the initialization script.
- 📦 backend.src.scripts.create_admin (
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]- 📝 Script entrypoint package root.
- 📦 backend.src.schemas.health (
Module)- 📝 Pydantic schemas for dashboard health summary.
- 🏗️ Layer: Domain
- ℂ DashboardHealthItem (
Class)[TRIVIAL]- 📝 Represents the latest health status of a single dashboard.
- ℂ HealthSummaryResponse (
Class)[TRIVIAL]- 📝 Aggregated health summary for all dashboards.
- 📦 backend.src.schemas.settings (
Module)- 📝 Pydantic schemas for application settings and automation policies.
- 🏗️ Layer: Domain
- ℂ NotificationChannel (
Class)[TRIVIAL]- 📝 Structured notification channel definition for policy-level custom routing.
- ℂ ValidationPolicyBase (
Class)[TRIVIAL]- 📝 Base schema for validation policy data.
- ℂ ValidationPolicyCreate (
Class)[TRIVIAL]- 📝 Schema for creating a new validation policy.
- ℂ ValidationPolicyUpdate (
Class)[TRIVIAL]- 📝 Schema for updating an existing validation policy.
- ℂ ValidationPolicyResponse (
Class)[TRIVIAL]- 📝 Schema for validation policy response data.
- 📦 backend.src.schemas.auth (
Module)- 📝 Pydantic schemas for authentication requests and responses.
- 🏗️ Layer: API
- 🔒 Invariant: Sensitive fields like password must not be included in response schemas.
- 🔗 DEPENDS_ON ->
pydantic - ℂ Token (
Class)[TRIVIAL]- 📝 Represents a JWT access token response.
- ℂ TokenData (
Class)[TRIVIAL]- 📝 Represents the data encoded in a JWT token.
- ℂ PermissionSchema (
Class)[TRIVIAL]- 📝 Represents a permission in API responses.
- ℂ RoleSchema (
Class)[CRITICAL]- 📝 Represents a role in API responses.
- ℂ RoleCreate (
Class)[CRITICAL]- 📝 Schema for creating a new role.
- ℂ RoleUpdate (
Class)[CRITICAL]- 📝 Schema for updating an existing role.
- ℂ ADGroupMappingSchema (
Class)[CRITICAL]- 📝 Represents an AD Group to Role mapping in API responses.
- ℂ ADGroupMappingCreate (
Class)[CRITICAL]- 📝 Schema for creating an AD Group mapping.
- ℂ UserBase (
Class)[CRITICAL]- 📝 Base schema for user data.
- ℂ UserCreate (
Class)[CRITICAL]- 📝 Schema for creating a new user.
- ℂ UserUpdate (
Class)[CRITICAL]- 📝 Schema for updating an existing user.
- ℂ User (
Class)[CRITICAL]- 📝 Schema for user data in API responses.
- 📦 backend.src.schemas.profile (
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.
- 🔗 DEPENDS_ON ->
pydantic - ℂ ProfilePermissionState (
Class)- 📝 Represents one permission badge state for profile read-only security view.
- ℂ ProfileSecuritySummary (
Class)- 📝 Read-only security and access snapshot for current user.
- ℂ ProfilePreference (
Class)- 📝 Represents persisted profile preference for a single authenticated user.
- ℂ ProfilePreferenceUpdateRequest (
Class)- 📝 Request payload for updating current user's profile settings.
- ℂ ProfilePreferenceResponse (
Class)- 📝 Response envelope for profile preference read/update endpoints.
- ℂ SupersetAccountLookupRequest (
Class)- 📝 Query contract for Superset account lookup by selected environment.
- ℂ SupersetAccountCandidate (
Class)- 📝 Canonical account candidate projected from Superset users payload.
- ℂ SupersetAccountLookupResponse (
Class)- 📝 Response envelope for Superset account lookup (success or degraded mode).
- 📦 src.schemas (
Package)[TRIVIAL]- 📝 API schema package root.
- 📦 backend.src.schemas.tests.test_settings_and_health_schemas (
Module)- 📝 Regression tests for settings and health schema contracts updated in 026 fix batch.
- ƒ test_validation_policy_create_accepts_structured_custom_channels (
Function)[TRIVIAL]- 📝 Ensure policy schema accepts structured custom channel objects with type/target fields.
- ƒ test_validation_policy_create_rejects_legacy_string_custom_channels (
Function)[TRIVIAL]- 📝 Ensure legacy list[str] custom channel payload is rejected by typed channel contract.
- ƒ test_dashboard_health_item_status_accepts_only_whitelisted_values (
Function)[TRIVIAL]- 📝 Verify strict grouped regex only accepts PASS/WARN/FAIL/UNKNOWN exact statuses.
- 📦 backend.src.core.superset_profile_lookup (
Module)- 📝 Provides environment-scoped Superset account lookup adapter with stable normalized output.
- 🏗️ Layer: Core
- 🔒 Invariant: Adapter never leaks raw upstream payload shape to API consumers.
- 🔗 DEPENDS_ON ->
backend.src.core.utils.network.APIClient - 🔗 DEPENDS_ON ->
backend.src.core.logger - ℂ SupersetAccountLookupAdapter (
Class)- 📝 Lookup Superset users and normalize candidates for profile binding.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes lookup adapter with authenticated API client and environment context.
- ƒ get_users_page (
Function)[TRIVIAL]- 📝 Fetch one users page from Superset with passthrough search/sort parameters.
- ƒ _normalize_lookup_payload (
Function)[TRIVIAL]- 📝 Convert Superset users response variants into stable candidates payload.
- ƒ normalize_user_payload (
Function)[TRIVIAL]- 📝 Project raw Superset user object to canonical candidate shape.
- 📦 backend.src.core.superset_client (
Module)- 📝 Предоставляет высокоуровневый клиент для взаимодействия с Superset REST API, инкапсулируя логику запросов, обработку ошибок и пагинацию.
- 🏗️ Layer: Core
- 🔒 Invariant: All network operations must use the internal APIClient instance.
- ℂ backend.src.core.superset_client.SupersetClient (
Class)- 📝 Класс-обёртка над Superset REST API, предоставляющий методы для работы с дашбордами и датасетами.
- 🔗 DEPENDS_ON ->
backend.src.core.utils.network.APIClient - 🔗 DEPENDS_ON ->
backend.src.core.config_models.Environment - ƒ backend.src.core.superset_client.SupersetClient.init (
Function)- 📝 Инициализирует клиент, проверяет конфигурацию и создает сетевой клиент.
- ƒ backend.src.core.superset_client.SupersetClient.authenticate (
Function)- 📝 Authenticates the client using the configured credentials.
- 🔗 CALLS ->
self.network.authenticate
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ authenticate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ headers (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboards (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboards_page (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboards_summary (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboards_summary_page (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _extract_owner_labels (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _extract_user_display (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _sanitize_user_text (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_chart (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboard_detail (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ extract_dataset_id_from_form_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_charts (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _extract_chart_ids_from_layout (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ walk (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ export_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ import_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ delete_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_datasets (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_datasets_summary (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dataset_detail (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ as_bool (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dataset (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ update_dataset (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_databases (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_database (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_databases_summary (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_database_by_uuid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _resolve_target_id_for_delete (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _do_import (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _validate_export_response (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _resolve_export_filename (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _validate_query_params (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _fetch_total_object_count (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _fetch_all_pages (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _validate_import_file (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_all_resources (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.core.encryption_key (
Module)[CRITICAL]- 📝 Resolve and persist the Fernet encryption key required by runtime services.
- 🏗️ Layer: Infra
- 🔒 Invariant: Runtime key resolution never falls back to an ephemeral secret.
- 🔗 DEPENDS_ON ->
backend.src.core.logger - ƒ ensure_encryption_key (
Function)[TRIVIAL]- 📝 Ensure backend runtime has a persistent valid Fernet key.
- 📦 ConfigManagerModule (
Module)[CRITICAL]- 📝 Manages application configuration persistence in DB with one-time migration from legacy JSON.
- 🏗️ Layer: Domain
- 🔒 Invariant: Configuration must always be representable by AppConfig and persisted under global record id.
- 🔗 DEPENDS_ON ->
backend.src.core.config_models.AppConfig - 🔗 DEPENDS_ON ->
backend.src.core.database.SessionLocal - 🔗 DEPENDS_ON ->
backend.src.models.config.AppConfigRecord - 🔗 CALLS ->
backend.src.core.logger.logger - 🔗 CALLS ->
backend.src.core.logger.configure_logger - ℂ ConfigManager (
Class)[CRITICAL]- 📝 Handles application configuration load, validation, mutation, and persistence lifecycle.
- ƒ init (
Function)[TRIVIAL]- 📝 Initialize manager state from persisted or migrated configuration.
- ƒ _default_config (
Function)- 📝 Build default application configuration fallback.
- ƒ _sync_raw_payload_from_config (
Function)- 📝 Merge typed AppConfig state into raw payload while preserving unsupported legacy sections.
- ƒ _load_from_legacy_file (
Function)- 📝 Load legacy JSON configuration for migration fallback path.
- ƒ _get_record (
Function)- 📝 Resolve global configuration record from DB.
- ƒ _load_config (
Function)- 📝 Load configuration from DB or perform one-time migration from legacy JSON.
- ƒ _save_config_to_db (
Function)- 📝 Persist provided AppConfig into the global DB configuration record.
- ƒ save (
Function)- 📝 Persist current in-memory configuration state.
- ƒ get_config (
Function)- 📝 Return current in-memory configuration snapshot.
- ƒ get_payload (
Function)- 📝 Return full persisted payload including sections outside typed AppConfig schema.
- ƒ save_config (
Function)- 📝 Persist configuration provided either as typed AppConfig or raw payload dict.
- ƒ update_global_settings (
Function)- 📝 Replace global settings and persist the resulting configuration.
- ƒ validate_path (
Function)- 📝 Validate that path exists and is writable, creating it when absent.
- ƒ get_environments (
Function)- 📝 Return all configured environments.
- ƒ has_environments (
Function)- 📝 Check whether at least one environment exists in configuration.
- ƒ get_environment (
Function)- 📝 Resolve a configured environment by identifier.
- ƒ add_environment (
Function)- 📝 Upsert environment by id into configuration and persist.
- ƒ update_environment (
Function)- 📝 Update existing environment by id and preserve masked password placeholder behavior.
- ƒ delete_environment (
Function)- 📝 Delete environment by id and persist when deletion occurs.
- 📦 SchedulerModule (
Module)- 📝 Manages scheduled tasks using APScheduler.
- 🏗️ Layer: Core
- ℂ SchedulerService (
Class)- 📝 Provides a service to manage scheduled backup tasks.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the scheduler service with task and config managers.
- ƒ start (
Function)[TRIVIAL]- 📝 Starts the background scheduler and loads initial schedules.
- ƒ stop (
Function)[TRIVIAL]- 📝 Stops the background scheduler.
- ƒ load_schedules (
Function)[TRIVIAL]- 📝 Loads backup schedules from configuration and registers them.
- ƒ add_backup_job (
Function)[TRIVIAL]- 📝 Adds a scheduled backup job for an environment.
- ƒ _trigger_backup (
Function)[TRIVIAL]- 📝 Triggered by the scheduler to start a backup task.
- ℂ ThrottledSchedulerConfigurator (
Class)[CRITICAL]- 📝 Distributes validation tasks evenly within an execution window.
- ƒ calculate_schedule (
Function)[TRIVIAL]- 📝 Calculates execution times for N tasks within a window.
- 🔒 Invariant: Tasks are distributed with near-even spacing.
- 📦 backend.src.core.config_models (
Module)- 📝 Defines the data models for application configuration using Pydantic.
- 🏗️ Layer: Core
- 📦 Schedule (
DataClass)[TRIVIAL]- 📝 Represents a backup schedule configuration.
- 📦 backend.src.core.config_models.Environment (
DataClass)[TRIVIAL]- 📝 Represents a Superset environment configuration.
- 📦 LoggingConfig (
DataClass)[TRIVIAL]- 📝 Defines the configuration for the application's logging system.
- 📦 CleanReleaseConfig (
DataClass)[TRIVIAL]- 📝 Configuration for clean release compliance subsystem.
- 📦 GlobalSettings (
DataClass)[TRIVIAL]- 📝 Represents global application settings.
- 📦 AppConfig (
DataClass)[TRIVIAL]- 📝 The root configuration model containing all application settings.
- 📦 backend.src.core.database (
Module)- 📝 Configures database connection and session management (PostgreSQL-first).
- 🏗️ Layer: Core
- 🔒 Invariant: A single engine instance is used for the entire application.
- 🔗 DEPENDS_ON ->
sqlalchemy - 🔗 DEPENDS_ON ->
backend.src.models.mapping - 🔗 DEPENDS_ON ->
backend.src.core.auth.config - 📦 BASE_DIR (
Variable)[TRIVIAL]- 📝 Base directory for the backend.
- 📦 DATABASE_URL (
Constant)[TRIVIAL]- 📝 URL for the main application database.
- 📦 TASKS_DATABASE_URL (
Constant)[TRIVIAL]- 📝 URL for the tasks execution database.
- 📦 AUTH_DATABASE_URL (
Constant)[TRIVIAL]- 📝 URL for the authentication database.
- 📦 engine (
Variable)[TRIVIAL]- 📝 SQLAlchemy engine for mappings database.
- 📦 tasks_engine (
Variable)[TRIVIAL]- 📝 SQLAlchemy engine for tasks database.
- 📦 auth_engine (
Variable)[TRIVIAL]- 📝 SQLAlchemy engine for authentication database.
- ℂ SessionLocal (
Class)[TRIVIAL]- 📝 A session factory for the main mappings database.
- ℂ TasksSessionLocal (
Class)[TRIVIAL]- 📝 A session factory for the tasks execution database.
- ℂ AuthSessionLocal (
Class)[TRIVIAL]- 📝 A session factory for the authentication database.
- ƒ _ensure_user_dashboard_preferences_columns (
Function)- 📝 Applies additive schema upgrades for user_dashboard_preferences table.
- ƒ _ensure_user_dashboard_preferences_health_columns (
Function)- 📝 Applies additive schema upgrades for user_dashboard_preferences table (health fields).
- ƒ _ensure_llm_validation_results_columns (
Function)- 📝 Applies additive schema upgrades for llm_validation_results table.
- ƒ _ensure_git_server_configs_columns (
Function)- 📝 Applies additive schema upgrades for git_server_configs table.
- ƒ ensure_connection_configs_table (
Function)- 📝 Ensures the external connection registry table exists in the main database.
- ƒ init_db (
Function)- 📝 Initializes the database by creating all tables.
- ƒ get_db (
Function)- 📝 Dependency for getting a database session.
- ƒ get_tasks_db (
Function)- 📝 Dependency for getting a tasks database session.
- ƒ get_auth_db (
Function)- 📝 Dependency for getting an authentication database session.
- ƒ _build_engine (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 LoggerModule (
Module)[TRIVIAL]- 📝 Configures the application's logging system, including a custom handler for buffering logs and streaming them over WebSockets.
- 🏗️ Layer: Core
- ℂ BeliefFormatter (
Class)[TRIVIAL]- 📝 Custom logging formatter that adds belief state prefixes to log messages.
- ƒ format (
Function)[TRIVIAL]- 📝 Formats the log record, adding belief state context if available.
- ℂ LogEntry (
Class)[TRIVIAL]- 📝 A Pydantic model representing a single, structured log entry. This is a re-definition for consistency, as it's also defined in task_manager.py.
- ƒ belief_scope (
Function)[TRIVIAL]- 📝 Context manager for structured Belief State logging.
- ƒ configure_logger (
Function)[TRIVIAL]- 📝 Configures the logger with the provided logging settings.
- ƒ get_task_log_level (
Function)[TRIVIAL]- 📝 Returns the current task log level filter.
- ƒ should_log_task_level (
Function)[TRIVIAL]- 📝 Checks if a log level should be recorded based on task_log_level setting.
- ℂ WebSocketLogHandler (
Class)[TRIVIAL]- 📝 A custom logging handler that captures log records into a buffer. It is designed to be extended for real-time log streaming over WebSockets.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the handler with a fixed-capacity buffer.
- ƒ emit (
Function)[TRIVIAL]- 📝 Captures a log record, formats it, and stores it in the buffer.
- ƒ get_recent_logs (
Function)[TRIVIAL]- 📝 Returns a list of recent log entries from the buffer.
- 📦 Logger (
Global)[TRIVIAL]- 📝 The global logger instance for the application, configured with both a console handler and the custom WebSocket handler.
- ƒ believed (
Function)[TRIVIAL]- 📝 A decorator that wraps a function in a belief scope.
- ƒ decorator (
Function)[TRIVIAL]- 📝 Internal decorator for belief scope.
- ƒ explore (
Function)[TRIVIAL]- 📝 Logs an EXPLORE message (Van der Waals force) for searching, alternatives, and hypotheses.
- ƒ reason (
Function)[TRIVIAL]- 📝 Logs a REASON message (Covalent bond) for strict deduction and core logic.
- ƒ reflect (
Function)[TRIVIAL]- 📝 Logs a REFLECT message (Hydrogen bond) for self-check and structural validation.
- ℂ PluginLoader (
Class)- 📝 Scans a specified directory for Python modules, dynamically loads them, and registers any classes that are valid implementations of the PluginBase interface.
- 🏗️ Layer: Core
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the PluginLoader with a directory to scan.
- ƒ _load_plugins (
Function)[TRIVIAL]- 📝 Scans the plugin directory and loads all valid plugins.
- ƒ _load_module (
Function)[TRIVIAL]- 📝 Loads a single Python module and discovers PluginBase implementations.
- ƒ _register_plugin (
Function)[TRIVIAL]- 📝 Registers a PluginBase instance and its configuration.
- ƒ get_plugin (
Function)[TRIVIAL]- 📝 Retrieves a loaded plugin instance by its ID.
- ƒ get_all_plugin_configs (
Function)[TRIVIAL]- 📝 Returns a list of all registered plugin configurations.
- ƒ has_plugin (
Function)[TRIVIAL]- 📝 Checks if a plugin with the given ID is registered.
- 📦 backend.src.core.migration_engine (
Module)[CRITICAL]- 📝 Transforms Superset export ZIP archives while preserving archive integrity and patching mapped identifiers.
- 🏗️ Layer: Domain
- 🔒 Invariant: ZIP structure and non-targeted metadata must remain valid after transformation.
- 🔗 DEPENDS_ON ->
src.core.logger - 🔗 DEPENDS_ON ->
src.core.mapping_service.IdMappingService - 🔗 DEPENDS_ON ->
src.models.mapping.ResourceType - 🔗 DEPENDS_ON ->
yaml - ℂ MigrationEngine (
Class)[CRITICAL]- 📝 Engine for transforming Superset export ZIPs.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes migration orchestration dependencies for ZIP/YAML metadata transformations.
- ƒ transform_zip (
Function)[TRIVIAL]- 📝 Extracts ZIP, replaces database UUIDs in YAMLs, patches cross-filters, and re-packages.
- ƒ _transform_yaml (
Function)[TRIVIAL]- 📝 Replaces database_uuid in a single YAML file.
- ƒ _extract_chart_uuids_from_archive (
Function)[TRIVIAL]- 📝 Scans extracted chart YAML files and builds a source chart ID to UUID lookup map.
- ƒ _patch_dashboard_metadata (
Function)[TRIVIAL]- 📝 Rewrites dashboard json_metadata chart/dataset integer identifiers using target environment mappings.
- 📦 backend.src.core.async_superset_client (
Module)[CRITICAL]- 📝 Async Superset client for dashboard hot-path requests without blocking FastAPI event loop.
- 🏗️ Layer: Core
- 🔒 Invariant: Async dashboard operations reuse shared auth cache and avoid sync requests in async routes.
- 🔗 DEPENDS_ON ->
backend.src.core.superset_client - 🔗 DEPENDS_ON ->
backend.src.core.utils.async_network.AsyncAPIClient - ℂ backend.src.core.async_superset_client.AsyncSupersetClient (
Class)- 📝 Async sibling of SupersetClient for dashboard read paths.
- 🔗 INHERITS ->
backend.src.core.superset_client.SupersetClient - 🔗 DEPENDS_ON ->
backend.src.core.utils.async_network.AsyncAPIClient - 🔗 CALLS ->
backend.src.core.utils.async_network.AsyncAPIClient.request - ƒ backend.src.core.async_superset_client.AsyncSupersetClient.init (
Function)- 📝 Initialize async Superset client with AsyncAPIClient transport.
- ƒ backend.src.core.async_superset_client.AsyncSupersetClient.aclose (
Function)- 📝 Close async transport resources.
- ƒ backend.src.core.async_superset_client.AsyncSupersetClient.get_dashboards_page_async (
Function)- 📝 Fetch one dashboards page asynchronously.
- ƒ get_dashboard_async (
Function)- 📝 Fetch one dashboard payload asynchronously.
- ƒ get_chart_async (
Function)- 📝 Fetch one chart payload asynchronously.
- ƒ get_dashboard_detail_async (
Function)- 📝 Fetch dashboard detail asynchronously with concurrent charts/datasets requests.
- 🔗 CALLS ->
self.get_dashboard_async - 🔗 CALLS ->
self.get_chart_async
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ aclose (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboards_page_async (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ extract_dataset_id_from_form_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ℂ PluginBase (
Class)[TRIVIAL]- 📝 Defines the abstract base class that all plugins must implement to be recognized by the system. It enforces a common structure for plugin metadata and execution.
- 🏗️ Layer: Core
- 🔒 Invariant: All plugins MUST inherit from this class.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the unique identifier for the plugin.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the human-readable name of the plugin.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns a brief description of the plugin.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the version of the plugin.
- ƒ required_permission (
Function)[TRIVIAL]- 📝 Returns the required permission string to execute this plugin.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend route for the plugin's UI, if applicable.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Returns the JSON schema for the plugin's input parameters.
- ƒ execute (
Function)[TRIVIAL]- 📝 Executes the plugin's core logic.
- ℂ PluginConfig (
Class)[TRIVIAL]- 📝 A Pydantic model used to represent the validated configuration and metadata of a loaded plugin. This object is what gets exposed to the API layer.
- 🏗️ Layer: Core
- 📦 src.core (
Package)[TRIVIAL]- 📝 Backend core services and infrastructure package root.
- 📦 backend.src.core.mapping_service (
Module)[CRITICAL]- 📝 Service for tracking and synchronizing Superset Resource IDs (UUID <-> Integer ID)
- 🏗️ Layer: Core
- 🔒 Invariant: sync_environment must handle remote API failures gracefully.
- 🔗 DEPENDS_ON ->
backend.src.models.mapping (ResourceMapping, ResourceType) - 🔗 DEPENDS_ON ->
backend.src.core.logger - ℂ IdMappingService (
Class)[CRITICAL]- 📝 Service handling the cataloging and retrieval of remote Superset Integer IDs.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the mapping service.
- ƒ start_scheduler (
Function)[TRIVIAL]- 📝 Starts the background scheduler with a given cron string.
- ƒ sync_environment (
Function)[TRIVIAL]- 📝 Fully synchronizes mapping for a specific environment.
- ƒ get_remote_id (
Function)[TRIVIAL]- 📝 Retrieves the remote integer ID for a given universal UUID.
- ƒ get_remote_ids_batch (
Function)[TRIVIAL]- 📝 Retrieves remote integer IDs for a list of universal UUIDs efficiently.
- ƒ sync_all (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.core.auth.config (
Module)[CRITICAL]- 📝 Centralized configuration for authentication and authorization.
- 🏗️ Layer: Core
- 🔒 Invariant: All sensitive configuration must have defaults or be loaded from environment.
- 🔗 DEPENDS_ON ->
pydantic - ℂ AuthConfig (
Class)[CRITICAL]- 📝 Holds authentication-related settings.
- 📦 auth_config (
Variable)[TRIVIAL]- 📝 Singleton instance of AuthConfig.
- 📦 backend.src.core.auth.jwt (
Module)- 📝 JWT token generation and validation logic.
- 🏗️ Layer: Core
- 🔒 Invariant: Tokens must include expiration time and user identifier.
- 🔗 DEPENDS_ON ->
jose - ƒ create_access_token (
Function)[TRIVIAL]- 📝 Generates a new JWT access token.
- ƒ decode_token (
Function)[TRIVIAL]- 📝 Decodes and validates a JWT token.
- 📦 backend.src.core.auth.oauth (
Module)[CRITICAL]- 📝 ADFS OIDC configuration and client using Authlib.
- 🏗️ Layer: Core
- 🔒 Invariant: Must use secure OIDC flows.
- 🔗 DEPENDS_ON ->
authlib - 📦 oauth (
Variable)[TRIVIAL]- 📝 Global Authlib OAuth registry.
- ƒ register_adfs (
Function)[TRIVIAL]- 📝 Registers the ADFS OIDC client.
- ƒ is_adfs_configured (
Function)[TRIVIAL]- 📝 Checks if ADFS is properly configured.
- 📦 backend.src.core.auth.logger (
Module)- 📝 Audit logging for security-related events.
- 🏗️ Layer: Core
- 🔒 Invariant: Must not log sensitive data like passwords or full tokens.
- ƒ log_security_event (
Function)[TRIVIAL]- 📝 Logs a security-related event for audit trails.
- 📦 backend.src.core.auth.security (
Module)[CRITICAL]- 📝 Utility for password hashing and verification using Passlib.
- 🏗️ Layer: Core
- 🔒 Invariant: Uses bcrypt for hashing with standard work factor.
- 🔗 DEPENDS_ON ->
passlib - ƒ verify_password (
Function)[TRIVIAL]- 📝 Verifies a plain password against a hashed password.
- ƒ get_password_hash (
Function)[TRIVIAL]- 📝 Generates a bcrypt hash for a plain password.
- 📦 backend.src.core.auth.repository (
Module)[CRITICAL]- 📝 Data access layer for authentication and user preference entities.
- 🏗️ Layer: Domain
- 🔒 Invariant: All database read/write operations must execute via the injected SQLAlchemy session boundary.
- 🔗 DEPENDS_ON ->
sqlalchemy.orm.Session - 🔗 DEPENDS_ON ->
backend.src.models.auth - 🔗 DEPENDS_ON ->
backend.src.models.profile - 🔗 DEPENDS_ON ->
backend.src.core.logger.belief_scope - ℂ AuthRepository (
Class)[CRITICAL]- 📝 Encapsulates database operations for authentication-related entities.
- 🔗 DEPENDS_ON ->
sqlalchemy.orm.Session - ƒ init (
Function)[CRITICAL]- 📝 Bind repository instance to an existing SQLAlchemy session.
- ƒ get_user_by_username (
Function)[CRITICAL]- 📝 Retrieve a user entity by unique username.
- ƒ get_user_by_id (
Function)[CRITICAL]- 📝 Retrieve a user entity by identifier.
- ƒ get_role_by_name (
Function)[CRITICAL]- 📝 Retrieve a role entity by role name.
- ƒ update_last_login (
Function)[CRITICAL]- 📝 Update last_login timestamp for the provided user entity.
- ƒ get_role_by_id (
Function)[CRITICAL]- 📝 Retrieve a role entity by identifier.
- ƒ get_permission_by_id (
Function)[CRITICAL]- 📝 Retrieve a permission entity by identifier.
- ƒ get_permission_by_resource_action (
Function)[CRITICAL]- 📝 Retrieve a permission entity by resource and action pair.
- ƒ get_user_dashboard_preference (
Function)[CRITICAL]- 📝 Retrieve dashboard preference entity owned by specified user.
- ƒ save_user_dashboard_preference (
Function)[CRITICAL]- 📝 Persist dashboard preference entity and return refreshed persistent row.
- ƒ list_permissions (
Function)[CRITICAL]- 📝 List all permission entities available in storage.
- 📦 src.core.auth (
Package)[TRIVIAL]- 📝 Authentication and authorization package root.
- 📦 test_auth (
Module)- 📝 Unit tests for authentication module
- 🏗️ Layer: Domain
- ƒ db_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ auth_service (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ auth_repo (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_authenticate_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_role_permission_association (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_user_role_association (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_ad_group_mapping (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_authenticate_user_updates_last_login (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_authenticate_inactive_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_verify_password_empty_hash (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_provision_adfs_user_new (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_provision_adfs_user_existing (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.core.utils.async_network (
Module)[CRITICAL]- 📝 Provides async Superset API client with shared auth-token cache to avoid per-request re-login.
- 🏗️ Layer: Infra
- 🔒 Invariant: Async client reuses cached auth tokens per environment credentials and invalidates on 401.
- 🔗 DEPENDS_ON ->
backend.src.core.utils.network.SupersetAuthCache - ℂ backend.src.core.utils.async_network.AsyncAPIClient (
Class)- 📝 Async Superset API client backed by httpx.AsyncClient with shared auth cache.
- 🔗 DEPENDS_ON ->
backend.src.core.utils.network.SupersetAuthCache - 🔗 CALLS ->
backend.src.core.utils.network.SupersetAuthCache.get - 🔗 CALLS ->
backend.src.core.utils.network.SupersetAuthCache.set - ƒ backend.src.core.utils.async_network.AsyncAPIClient.init (
Function)- 📝 Initialize async API client for one environment.
- ƒ backend.src.core.utils.async_network.AsyncAPIClient._normalize_base_url (
Function)[TRIVIAL]- 📝 Normalize base URL for Superset API root construction.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _normalize_base_url (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.core.utils.fileio (
Module)[TRIVIAL]- 📝 Предоставляет набор утилит для управления файловыми операциями, включая работу с временными файлами, архивами ZIP, файлами YAML и очистку директорий.
- 🏗️ Layer: Infra
- 🔗 DEPENDS_ON ->
backend.src.core.logger - 🔗 DEPENDS_ON ->
pyyaml - ℂ InvalidZipFormatError (
Class)[TRIVIAL]- 📝 Exception raised when a file is not a valid ZIP archive.
- ƒ create_temp_file (
Function)[TRIVIAL]- 📝 Контекстный менеджер для создания временного файла или директории с гарантированным удалением.
- ƒ remove_empty_directories (
Function)[TRIVIAL]- 📝 Рекурсивно удаляет все пустые поддиректории, начиная с указанного пути.
- ƒ read_dashboard_from_disk (
Function)[TRIVIAL]- 📝 Читает бинарное содержимое файла с диска.
- ƒ calculate_crc32 (
Function)[TRIVIAL]- 📝 Вычисляет контрольную сумму CRC32 для файла.
- 📦 RetentionPolicy (
DataClass)[TRIVIAL]- 📝 Определяет политику хранения для архивов (ежедневные, еженедельные, ежемесячные).
- ƒ archive_exports (
Function)[TRIVIAL]- 📝 Управляет архивом экспортированных файлов, применяя политику хранения и дедупликацию.
- 🔗 CALLS ->
apply_retention_policy - 🔗 CALLS ->
calculate_crc32
- ƒ apply_retention_policy (
Function)[TRIVIAL]- 📝 (Helper) Применяет политику хранения к списку файлов, возвращая те, что нужно сохранить.
- ƒ save_and_unpack_dashboard (
Function)[TRIVIAL]- 📝 Сохраняет бинарное содержимое ZIP-архива на диск и опционально распаковывает его.
- ƒ update_yamls (
Function)[TRIVIAL]- 📝 Обновляет конфигурации в YAML-файлах, заменяя значения или применяя regex.
- 🔗 CALLS ->
_update_yaml_file
- ƒ _update_yaml_file (
Function)[TRIVIAL]- 📝 (Helper) Обновляет один YAML файл.
- ƒ replacer (
Function)[TRIVIAL]- 📝 Функция замены, сохраняющая кавычки если они были.
- ƒ create_dashboard_export (
Function)[TRIVIAL]- 📝 Создает ZIP-архив из указанных исходных путей.
- ƒ sanitize_filename (
Function)[TRIVIAL]- 📝 Очищает строку от символов, недопустимых в именах файлов.
- ƒ get_filename_from_headers (
Function)[TRIVIAL]- 📝 Извлекает имя файла из HTTP заголовка 'Content-Disposition'.
- ƒ consolidate_archive_folders (
Function)[TRIVIAL]- 📝 Консолидирует директории архивов на основе общего слага в имени.
- 📦 network (
Module)- 📝 Инкапсулирует низкоуровневую HTTP-логику для взаимодействия с Superset API, включая аутентификацию, управление сессией, retry-логику и обработку ошибок.
- 🏗️ Layer: Infra
- 🔗 DEPENDS_ON ->
backend.src.core.logger - 🔗 DEPENDS_ON ->
requests - ℂ SupersetAPIError (
Class)[TRIVIAL]- 📝 Base exception for all Superset API related errors.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the exception with a message and context.
- ℂ AuthenticationError (
Class)[TRIVIAL]- 📝 Exception raised when authentication fails.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the authentication error.
- ℂ PermissionDeniedError (
Class)[TRIVIAL]- 📝 Exception raised when access is denied.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the permission denied error.
- ℂ DashboardNotFoundError (
Class)[TRIVIAL]- 📝 Exception raised when a dashboard cannot be found.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the not found error with resource ID.
- ℂ NetworkError (
Class)[TRIVIAL]- 📝 Exception raised when a network level error occurs.
- ƒ network.APIClient.init (
Function)[TRIVIAL]- 📝 Initializes the network error.
- ℂ network.SupersetAuthCache (
Class)[TRIVIAL]- 📝 Process-local cache for Superset access/csrf tokens keyed by environment credentials.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ build_key (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ set (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ invalidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init_poolmanager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.core.utils.matching (
Module)[TRIVIAL]- 📝 Provides utility functions for fuzzy matching database names.
- 🏗️ Layer: Core
- 🔒 Invariant: Confidence scores are returned as floats between 0.0 and 1.0.
- 🔗 DEPENDS_ON ->
rapidfuzz - ƒ suggest_mappings (
Function)[TRIVIAL]- 📝 Suggests mappings between source and target databases using fuzzy matching.
- 📦 backend.core.utils.dataset_mapper (
Module)[TRIVIAL]- 📝 Этот модуль отвечает за обновление метаданных (verbose_map) в датасетах Superset, извлекая их из PostgreSQL или XLSX-файлов.
- 🏗️ Layer: Domain
- 🔗 DEPENDS_ON ->
backend.core.superset_client - 🔗 DEPENDS_ON ->
pandas - 🔗 DEPENDS_ON ->
psycopg2 - ℂ DatasetMapper (
Class)[TRIVIAL]- 📝 Класс для меппинга и обновления verbose_map в датасетах Superset.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the mapper.
- ƒ get_postgres_comments (
Function)[TRIVIAL]- 📝 Извлекает комментарии к колонкам из системного каталога PostgreSQL.
- ƒ load_excel_mappings (
Function)[TRIVIAL]- 📝 Загружает меппинги 'column_name' -> 'column_comment' из XLSX файла.
- ƒ run_mapping (
Function)[TRIVIAL]- 📝 Основная функция для выполнения меппинга и обновления verbose_map датасета в Superset.
- 🔗 CALLS ->
self.get_postgres_comments - 🔗 CALLS ->
self.load_excel_mappings - 🔗 CALLS ->
superset_client.get_dataset - 🔗 CALLS ->
superset_client.update_dataset
- 📦 src.core.utils (
Package)[TRIVIAL]- 📝 Shared utility package root.
- 📦 backend.src.core.tests.test_superset_profile_lookup (
Module)- 📝 Verifies Superset profile lookup adapter payload normalization and fallback error precedence.
- 🏗️ Layer: Domain
- ℂ _RecordingNetworkClient (
Class)[TRIVIAL]- 📝 Records request payloads and returns scripted responses for deterministic adapter tests.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes scripted network responses.
- ƒ request (
Function)[TRIVIAL]- 📝 Mimics APIClient.request while capturing call arguments.
- ƒ test_get_users_page_sends_lowercase_order_direction (
Function)[TRIVIAL]- 📝 Ensures adapter sends lowercase order_direction compatible with Superset rison schema.
- ƒ test_get_users_page_preserves_primary_schema_error_over_fallback_auth_error (
Function)[TRIVIAL]- 📝 Ensures fallback auth error does not mask primary schema/query failure.
- ƒ test_get_users_page_uses_fallback_endpoint_when_primary_fails (
Function)[TRIVIAL]- 📝 Verifies adapter retries second users endpoint and succeeds when fallback is healthy.
- 📦 test_throttled_scheduler (
Module)- 📝 Unit tests for ThrottledSchedulerConfigurator distribution logic.
- ƒ test_calculate_schedule_even_distribution (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_calculate_schedule_midnight_crossing (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_calculate_schedule_single_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_calculate_schedule_empty_list (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_calculate_schedule_zero_window (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_calculate_schedule_very_small_window (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.core.tests.test_config_manager_compat (
Module)- 📝 Verifies ConfigManager compatibility wrappers preserve legacy payload sections.
- 🏗️ Layer: Domain
- ƒ test_get_payload_preserves_legacy_sections (
Function)[TRIVIAL]- 📝 Ensure get_payload merges typed config into raw payload without dropping legacy sections.
- ƒ test_save_config_accepts_raw_payload_and_keeps_extras (
Function)[TRIVIAL]- 📝 Ensure save_config accepts raw dict payload, refreshes typed config, and preserves extra sections.
- ƒ _capture_save (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_logger (
Module)- 📝 Unit tests for logger module
- 🏗️ Layer: Infra
- ƒ test_belief_scope_logs_entry_action_exit_at_debug (
Function)[TRIVIAL]- 📝 Test that belief_scope generates [ID][Entry], [ID][Action], and [ID][Exit] logs at DEBUG level.
- ƒ test_belief_scope_error_handling (
Function)[TRIVIAL]- 📝 Test that belief_scope logs Coherence:Failed on exception.
- ƒ test_belief_scope_success_coherence (
Function)[TRIVIAL]- 📝 Test that belief_scope logs Coherence:OK on success.
- ƒ test_belief_scope_not_visible_at_info (
Function)[TRIVIAL]- 📝 Test that belief_scope Entry/Exit/Coherence logs are NOT visible at INFO level.
- ƒ test_task_log_level_default (
Function)[TRIVIAL]- 📝 Test that default task log level is INFO.
- ƒ test_should_log_task_level (
Function)[TRIVIAL]- 📝 Test that should_log_task_level correctly filters log levels.
- ƒ test_configure_logger_task_log_level (
Function)[TRIVIAL]- 📝 Test that configure_logger updates task_log_level.
- ƒ test_enable_belief_state_flag (
Function)[TRIVIAL]- 📝 Test that enable_belief_state flag controls belief_scope logging.
- ƒ test_belief_scope_missing_anchor (
Function)[TRIVIAL]- 📝 Test @PRE condition: anchor_id must be provided
- ƒ test_configure_logger_post_conditions (
Function)[TRIVIAL]- 📝 Test @POST condition: Logger level, handlers, belief state flag, and task log level are updated.
- ƒ reset_logger_state (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.core.migration.dry_run_orchestrator (
Module)- 📝 Compute pre-flight migration diff and risk scoring without apply.
- 🏗️ Layer: Core
- 🔒 Invariant: Dry run is informative only and must not mutate target environment.
- 🔗 DEPENDS_ON ->
backend.src.core.superset_client.SupersetClient - 🔗 DEPENDS_ON ->
backend.src.core.migration_engine.MigrationEngine - 🔗 DEPENDS_ON ->
backend.src.core.migration.archive_parser.MigrationArchiveParser - 🔗 DEPENDS_ON ->
backend.src.core.migration.risk_assessor - ℂ MigrationDryRunService (
Class)[CRITICAL]- 📝 Build deterministic diff/risk payload for migration pre-flight.
- ƒ init (
Function)[TRIVIAL]- 📝 Wire parser dependency for archive object extraction.
- ƒ run (
Function)[TRIVIAL]- 📝 Execute full dry-run computation for selected dashboards.
- ƒ _load_db_mapping (
Function)[TRIVIAL]- 📝 Resolve UUID mapping for optional DB config replacement.
- ƒ _accumulate_objects (
Function)[TRIVIAL]- 📝 Merge extracted resources by UUID to avoid duplicates.
- ƒ _index_by_uuid (
Function)[TRIVIAL]- 📝 Build UUID-index map for normalized resources.
- ƒ _build_object_diff (
Function)[TRIVIAL]- 📝 Compute create/update/delete buckets by UUID+signature.
- ƒ _build_target_signatures (
Function)[TRIVIAL]- 📝 Pull target metadata and normalize it into comparable signatures.
- ƒ _build_risks (
Function)[TRIVIAL]- 📝 Build risk items for missing datasource, broken refs, overwrite, owner mismatch.
- 📦 backend.src.core.migration.archive_parser (
Module)- 📝 Parse Superset export ZIP archives into normalized object catalogs for diffing.
- 🏗️ Layer: Core
- 🔒 Invariant: Parsing is read-only and never mutates archive files.
- 🔗 DEPENDS_ON ->
backend.src.core.logger - ℂ MigrationArchiveParser (
Class)[CRITICAL]- 📝 Extract normalized dashboards/charts/datasets metadata from ZIP archives.
- ƒ extract_objects_from_zip (
Function)[TRIVIAL]- 📝 Extract object catalogs from Superset archive.
- ƒ _collect_yaml_objects (
Function)[TRIVIAL]- 📝 Read and normalize YAML manifests for one object type.
- ƒ _normalize_object_payload (
Function)[TRIVIAL]- 📝 Convert raw YAML payload to stable diff signature shape.
- 📦 backend.src.core.migration.risk_assessor (
Module)[CRITICAL]- 📝 Compute deterministic migration risk items and aggregate score for dry-run reporting.
- 🏗️ Layer: Domain
- 🔒 Invariant: Risk scoring must remain bounded to [0,100] and preserve severity-to-weight mapping.
- 🔗 DEPENDS_ON ->
backend.src.core.superset_client.SupersetClient - 🔗 DISPATCHES ->
backend.src.core.migration.dry_run_orchestrator.MigrationDryRunService.run - ƒ index_by_uuid (
Function)[TRIVIAL]- 📝 Build UUID-index from normalized objects.
- ƒ extract_owner_identifiers (
Function)[TRIVIAL]- 📝 Normalize owner payloads for stable comparison.
- ƒ build_risks (
Function)[TRIVIAL]- 📝 Build risk list from computed diffs and target catalog state.
- ƒ score_risks (
Function)[TRIVIAL]- 📝 Aggregate risk list into score and level.
- 📦 backend.src.core.migration.init (
Module)[TRIVIAL]- 📝 Namespace package for migration pre-flight orchestration components.
- 🏗️ Layer: Core
- 📦 TaskLoggerModule (
Module)[CRITICAL]- 📝 Provides a dedicated logger for tasks with automatic source attribution.
- 🏗️ Layer: Core
- 🔒 Invariant: Each TaskLogger instance is bound to a specific task_id and default source.
- 🔗 DEPENDS_ON ->
TaskManager, CALLS -> TaskManager._add_log - ℂ TaskLogger (
Class)[CRITICAL]- 📝 A wrapper around TaskManager._add_log that carries task_id and source context.
- 🔒 Invariant: All log calls include the task_id and source.
- ƒ init (
Function)[TRIVIAL]- 📝 Initialize the TaskLogger with task context.
- ƒ with_source (
Function)[TRIVIAL]- 📝 Create a sub-logger with a different default source.
- ƒ _log (
Function)[TRIVIAL]- 📝 Internal method to log a message at a given level.
- ƒ debug (
Function)[TRIVIAL]- 📝 Log a DEBUG level message.
- ƒ info (
Function)[TRIVIAL]- 📝 Log an INFO level message.
- ƒ warning (
Function)[TRIVIAL]- 📝 Log a WARNING level message.
- ƒ error (
Function)[TRIVIAL]- 📝 Log an ERROR level message.
- ƒ progress (
Function)[TRIVIAL]- 📝 Log a progress update with percentage.
- 📦 TaskPersistenceModule (
Module)[CRITICAL]- 📝 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 ->
TasksSessionLocal - ℂ TaskPersistenceService (
Class)[CRITICAL]- 📝 Provides methods to save, load, and delete task records in tasks.db using SQLAlchemy models.
- 🔒 Invariant: Persistence must handle potentially missing task fields natively.
- 🔗 DEPENDS_ON ->
TasksSessionLocal - 🔗 DEPENDS_ON ->
TaskRecord - 🔗 DEPENDS_ON ->
Environment - ƒ _json_load_if_needed (
Function)[TRIVIAL]- 📝 Safely load JSON strings from DB if necessary
- ƒ _parse_datetime (
Function)[TRIVIAL]- 📝 Safely parse a datetime string from the database
- ƒ _resolve_environment_id (
Function)- 📝 Resolve environment id into existing environments.id value to satisfy FK constraints.
- ƒ init (
Function)- 📝 Initializes the persistence service.
- ƒ persist_task (
Function)- 📝 Persists or updates a single task in the database.
- 🔗 CALLS ->
_resolve_environment_id
- ƒ persist_tasks (
Function)- 📝 Persists multiple tasks.
- 🔗 CALLS ->
persist_task
- ƒ load_tasks (
Function)- 📝 Loads tasks from the database.
- 🔗 CALLS ->
_json_load_if_needed - 🔗 CALLS ->
_parse_datetime
- ƒ delete_tasks (
Function)- 📝 Deletes specific tasks from the database.
- ℂ TaskLogPersistenceService (
Class)[CRITICAL]- 📝 Provides methods to store, query, summarize, and delete task log rows in the task_logs table.
- 🔒 Invariant: Log entries are batch-inserted for performance.
- 🔗 DEPENDS_ON ->
TaskLogRecord - 🔗 DEPENDS_ON ->
TasksSessionLocal - ƒ init (
Function)- 📝 Initializes the TaskLogPersistenceService
- ƒ add_logs (
Function)- 📝 Batch insert log entries for a task.
- ƒ get_logs (
Function)- 📝 Query logs for a task with filtering and pagination.
- ƒ get_log_stats (
Function)- 📝 Get statistics about logs for a task.
- ƒ get_sources (
Function)- 📝 Get unique sources for a task's logs.
- ƒ delete_logs_for_task (
Function)- 📝 Delete all logs for a specific task.
- ƒ delete_logs_for_tasks (
Function)- 📝 Delete all logs for multiple tasks.
- ƒ normalize_token (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ json_serializable (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 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 ->
backend.src.core.plugin_loader - 🔗 DEPENDS_ON ->
backend.src.core.task_manager.persistence - ℂ TaskManager (
Class)[CRITICAL]- 📝 Manages the lifecycle of tasks, including their creation, execution, and state tracking.
- 🔒 Invariant: Log entries are never deleted after being added to a task.
- ƒ init (
Function)[CRITICAL]- 📝 Initialize the TaskManager with dependencies.
- ƒ _flusher_loop (
Function)- 📝 Background thread that periodically flushes log buffer to database.
- ƒ _flush_logs (
Function)- 📝 Flush all buffered logs to the database.
- ƒ _flush_task_logs (
Function)- 📝 Flush logs for a specific task immediately.
- ƒ create_task (
Function)- 📝 Creates and queues a new task for execution.
- ƒ _run_task (
Function)- 📝 Internal method to execute a task with TaskContext support.
- ƒ resolve_task (
Function)- 📝 Resumes a task that is awaiting mapping.
- ƒ wait_for_resolution (
Function)- 📝 Pauses execution and waits for a resolution signal.
- ƒ wait_for_input (
Function)- 📝 Pauses execution and waits for user input.
- ƒ get_task (
Function)- 📝 Retrieves a task by its ID.
- ƒ get_all_tasks (
Function)- 📝 Retrieves all registered tasks.
- ƒ get_tasks (
Function)- 📝 Retrieves tasks with pagination and optional status filter.
- ƒ get_task_logs (
Function)- 📝 Retrieves logs for a specific task (from memory for running, persistence for completed).
- ƒ get_task_log_stats (
Function)- 📝 Get statistics about logs for a task.
- ƒ get_task_log_sources (
Function)- 📝 Get unique sources for a task's logs.
- ƒ _add_log (
Function)- 📝 Adds a log entry to a task buffer and notifies subscribers.
- ƒ subscribe_logs (
Function)- 📝 Subscribes to real-time logs for a task.
- ƒ unsubscribe_logs (
Function)- 📝 Unsubscribes from real-time logs for a task.
- ƒ load_persisted_tasks (
Function)- 📝 Load persisted tasks using persistence service.
- ƒ await_input (
Function)- 📝 Transition a task to AWAITING_INPUT state with input request.
- ƒ resume_task_with_password (
Function)- 📝 Resume a task that is awaiting input with provided passwords.
- ƒ clear_tasks (
Function)- 📝 Clears tasks based on status filter (also deletes associated logs).
- ƒ sort_key (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 TaskManagerModels (
Module)- 📝 Defines the data models and enumerations used by the Task Manager.
- 🏗️ Layer: Core
- 🔒 Invariant: Task IDs are immutable once created.
- 📦 TaskStatus (
Enum)[TRIVIAL]- 📝 Defines the possible states a task can be in during its lifecycle.
- 📦 LogLevel (
Enum)- 📝 Defines the possible log levels for task logging.
- ℂ LogEntry (
Class)[CRITICAL]- 📝 A Pydantic model representing a single, structured log entry associated with a task.
- 🔒 Invariant: Each log entry has a unique timestamp and source.
- ℂ TaskLog (
Class)- 📝 A Pydantic model representing a persisted log entry from the database.
- ℂ LogFilter (
Class)- 📝 Filter parameters for querying task logs.
- ℂ LogStats (
Class)- 📝 Statistics about log entries for a task.
- ℂ Task (
Class)- 📝 A Pydantic model representing a single execution instance of a plugin, including its status, parameters, and logs.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the Task model and validates input_request for AWAITING_INPUT status.
- 📦 TaskCleanupModule (
Module)- 📝 Implements task cleanup and retention policies, including associated logs.
- 🏗️ Layer: Core
- ℂ TaskCleanupService (
Class)- 📝 Provides methods to clean up old task records and their associated logs.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the cleanup service with dependencies.
- ƒ run_cleanup (
Function)[TRIVIAL]- 📝 Deletes tasks older than the configured retention period and their logs.
- ƒ delete_task_with_logs (
Function)[TRIVIAL]- 📝 Delete a single task and all its associated logs.
- 📦 TaskManagerPackage (
Module)[TRIVIAL]- 📝 Exports the public API of the task manager package.
- 🏗️ Layer: Core
- 🔒 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
- 📦 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 ->
TaskLogger, USED_BY -> plugins - ℂ 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.
- ƒ init (
Function)[TRIVIAL]- 📝 Initialize the TaskContext with task-specific resources.
- ƒ task_id (
Function)[TRIVIAL]- 📝 Get the task ID.
- ƒ logger (
Function)[TRIVIAL]- 📝 Get the TaskLogger instance for this context.
- ƒ params (
Function)[TRIVIAL]- 📝 Get the task parameters.
- ƒ background_tasks (
Function)[TRIVIAL]- 📝 Expose optional background task scheduler for plugins that dispatch deferred side effects.
- ƒ get_param (
Function)[TRIVIAL]- 📝 Get a specific parameter value with optional default.
- ƒ create_sub_context (
Function)[TRIVIAL]- 📝 Create a sub-context with a different default source.
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_task_logger (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/core/task_manager/tests/test_task_logger.py
- 🏗️ Layer: Unknown
- ƒ mock_add_log (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ task_logger (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_task_logger_initialization (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_log_methods_delegation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_with_source (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_missing_task_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_invalid_add_log_fn (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_progress_log (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.core.task_manager.tests.test_context (
Module)- 📝 Verify TaskContext preserves optional background task scheduler across sub-context creation.
- ƒ test_task_context_preserves_background_tasks_across_sub_context (
Function)[TRIVIAL]- 📝 Plugins must be able to access background_tasks from both root and sub-context loggers.
- 📦 backend.src.api.auth (
Module)- 📝 Authentication API endpoints.
- 🏗️ Layer: API
- 🔒 Invariant: All auth endpoints must return consistent error codes.
- 📦 router (
Variable)[TRIVIAL]- 📝 APIRouter instance for authentication routes.
- ƒ login_for_access_token (
Function)- 📝 Authenticates a user and returns a JWT access token.
- ƒ read_users_me (
Function)- 📝 Retrieves the profile of the currently authenticated user.
- ƒ logout (
Function)- 📝 Logs out the current user (placeholder for session revocation).
- ƒ login_adfs (
Function)- 📝 Initiates the ADFS OIDC login flow.
- ƒ auth_callback_adfs (
Function)- 📝 Handles the callback from ADFS after successful authentication.
- 📦 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).
- 📦 backend.src.api.routes.datasets (
Module)- 📝 API endpoints for the Dataset Hub - listing datasets with mapping progress
- 🏗️ Layer: API
- 🔒 Invariant: All dataset responses include last_task metadata
- 🔗 DEPENDS_ON ->
backend.src.dependencies - 🔗 DEPENDS_ON ->
backend.src.services.resource_service.ResourceService - 🔗 DEPENDS_ON ->
backend.src.core.superset_client.SupersetClient - 📦 MappedFields (
DataClass)[TRIVIAL]- 📝 DTO for dataset mapping progress statistics
- 📦 LastTask (
DataClass)[TRIVIAL]- 📝 DTO for the most recent task associated with a dataset
- 📦 DatasetItem (
DataClass)[TRIVIAL]- 📝 Summary DTO for a dataset in the hub listing
- 📦 LinkedDashboard (
DataClass)[TRIVIAL]- 📝 DTO for a dashboard linked to a dataset
- 📦 DatasetColumn (
DataClass)[TRIVIAL]- 📝 DTO for a single dataset column's metadata
- 📦 DatasetDetailResponse (
DataClass)[TRIVIAL]- 📝 Detailed DTO for a dataset including columns and links
- 📦 DatasetsResponse (
DataClass)[TRIVIAL]- 📝 Paginated response DTO for dataset listings
- 📦 TaskResponse (
DataClass)[TRIVIAL]- 📝 Response DTO containing a task ID for tracking
- ƒ get_dataset_ids (
Function)- 📝 Fetch list of all dataset IDs from a specific environment (without pagination)
- 🔗 CALLS ->
get_datasets_with_status
- ƒ get_datasets (
Function)- 📝 Fetch list of datasets from a specific environment with mapping progress
- 🔗 CALLS ->
backend.src.services.resource_service.ResourceService.get_datasets_with_status
- 📦 MapColumnsRequest (
DataClass)[TRIVIAL]- 📝 Request DTO for initiating column mapping
- ƒ map_columns (
Function)- 📝 Trigger bulk column mapping for datasets
- 🔗 DISPATCHES ->
backend.src.plugins.mapper.MapperPlugin - 🔗 CALLS ->
backend.src.core.task_manager.manager.TaskManager:create_task
- 📦 GenerateDocsRequest (
DataClass)[TRIVIAL]- 📝 Request DTO for initiating documentation generation
- ƒ generate_docs (
Function)- 📝 Trigger bulk documentation generation for datasets
- 🔗 DISPATCHES ->
backend.src.plugins.llm_analysis.plugin.DocumentationPlugin - 🔗 CALLS ->
backend.src.core.task_manager.manager.TaskManager:create_task
- ƒ get_dataset_detail (
Function)- 📝 Get detailed dataset information including columns and linked dashboards
- 🔗 CALLS ->
backend.src.core.superset_client.SupersetClient:get_dataset_detail
- 📦 backend.src.api.routes.git (
Module)- 📝 Provides FastAPI endpoints for Git integration operations.
- 🏗️ Layer: API
- 🔒 Invariant: All Git operations must be routed through GitService.
- ƒ _build_no_repo_status_payload (
Function)[TRIVIAL]- 📝 Build a consistent status payload for dashboards without initialized repositories.
- ƒ _handle_unexpected_git_route_error (
Function)[TRIVIAL]- 📝 Convert unexpected route-level exceptions to stable 500 API responses.
- ƒ _resolve_repository_status (
Function)- 📝 Resolve repository status for one dashboard with graceful NO_REPO semantics.
- ƒ _get_git_config_or_404 (
Function)- 📝 Resolve GitServerConfig by id or raise 404.
- ƒ _find_dashboard_id_by_slug (
Function)- 📝 Resolve dashboard numeric ID by slug in a specific environment.
- ƒ _resolve_dashboard_id_from_ref (
Function)- 📝 Resolve dashboard ID from slug-or-id reference for Git routes.
- ƒ _find_dashboard_id_by_slug_async (
Function)- 📝 Resolve dashboard numeric ID by slug asynchronously for hot-path Git routes.
- ƒ _resolve_dashboard_id_from_ref_async (
Function)- 📝 Resolve dashboard ID asynchronously from slug-or-id reference for hot Git routes.
- ƒ _resolve_repo_key_from_ref (
Function)- 📝 Resolve repository folder key with slug-first strategy and deterministic fallback.
- ƒ _sanitize_optional_identity_value (
Function)[TRIVIAL]- 📝 Normalize optional identity value into trimmed string or None.
- ƒ _resolve_current_user_git_identity (
Function)- 📝 Resolve configured Git username/email from current user's profile preferences.
- ƒ _apply_git_identity_from_profile (
Function)- 📝 Apply user-scoped Git identity to repository-local config before write/pull operations.
- ƒ get_git_configs (
Function)- 📝 List all configured Git servers.
- ƒ create_git_config (
Function)- 📝 Register a new Git server configuration.
- ƒ update_git_config (
Function)- 📝 Update an existing Git server configuration.
- ƒ delete_git_config (
Function)- 📝 Remove a Git server configuration.
- ƒ test_git_config (
Function)- 📝 Validate connection to a Git server using provided credentials.
- ƒ list_gitea_repositories (
Function)- 📝 List repositories in Gitea for a saved Gitea config.
- ƒ create_gitea_repository (
Function)- 📝 Create a repository in Gitea for a saved Gitea config.
- ƒ create_remote_repository (
Function)- 📝 Create repository on remote Git server using selected provider config.
- ƒ delete_gitea_repository (
Function)- 📝 Delete repository in Gitea for a saved Gitea config.
- ƒ init_repository (
Function)- 📝 Link a dashboard to a Git repository and perform initial clone/init.
- ƒ get_repository_binding (
Function)- 📝 Return repository binding with provider metadata for selected dashboard.
- ƒ delete_repository (
Function)- 📝 Delete local repository workspace and DB binding for selected dashboard.
- ƒ get_branches (
Function)- 📝 List all branches for a dashboard's repository.
- ƒ create_branch (
Function)- 📝 Create a new branch in the dashboard's repository.
- ƒ checkout_branch (
Function)- 📝 Switch the dashboard's repository to a specific branch.
- ƒ commit_changes (
Function)- 📝 Stage and commit changes in the dashboard's repository.
- ƒ push_changes (
Function)- 📝 Push local commits to the remote repository.
- ƒ pull_changes (
Function)- 📝 Pull changes from the remote repository.
- ƒ get_merge_status (
Function)- 📝 Return unfinished-merge status for repository (web-only recovery support).
- ƒ get_merge_conflicts (
Function)- 📝 Return conflicted files with mine/theirs previews for web conflict resolver.
- ƒ resolve_merge_conflicts (
Function)- 📝 Apply mine/theirs/manual conflict resolutions from WebUI and stage files.
- ƒ abort_merge (
Function)- 📝 Abort unfinished merge from WebUI flow.
- ƒ continue_merge (
Function)- 📝 Finalize unfinished merge from WebUI flow.
- ƒ sync_dashboard (
Function)- 📝 Sync dashboard state from Superset to Git using the GitPlugin.
- ƒ promote_dashboard (
Function)- 📝 Promote changes between branches via MR or direct merge.
- ƒ get_environments (
Function)- 📝 List all deployment environments.
- ƒ deploy_dashboard (
Function)- 📝 Deploy dashboard from Git to a target environment.
- ƒ get_history (
Function)- 📝 View commit history for a dashboard's repository.
- ƒ get_repository_status (
Function)- 📝 Get current Git status for a dashboard repository.
- ƒ get_repository_status_batch (
Function)- 📝 Get Git statuses for multiple dashboard repositories in one request.
- ƒ get_repository_diff (
Function)- 📝 Get Git diff for a dashboard repository.
- ƒ generate_commit_message (
Function)- 📝 Generate a suggested commit message using LLM.
- 📦 ConnectionsRouter (
Module)[TRIVIAL]- 📝 Defines the FastAPI router for managing external database connections.
- 🏗️ Layer: UI (API)
- ƒ _ensure_connections_schema (
Function)[TRIVIAL]- 📝 Ensures the connection_configs table exists before CRUD access.
- ℂ ConnectionSchema (
Class)[TRIVIAL]- 📝 Pydantic model for connection response.
- ℂ ConnectionCreate (
Class)[TRIVIAL]- 📝 Pydantic model for creating a connection.
- ƒ list_connections (
Function)[TRIVIAL]- 📝 Lists all saved connections.
- ƒ create_connection (
Function)[TRIVIAL]- 📝 Creates a new connection configuration.
- ƒ delete_connection (
Function)[TRIVIAL]- 📝 Deletes a connection configuration.
- 📦 health_router (
Module)- 📝 API endpoints for dashboard health monitoring and status aggregation.
- 🏗️ Layer: UI/API
- 🔗 DEPENDS_ON ->
health_service - ƒ get_health_summary (
Function)[TRIVIAL]- 📝 Get aggregated health status for all dashboards.
- 🔗 CALLS ->
backend.src.services.health_service.HealthService
- ƒ delete_health_report (
Function)[TRIVIAL]- 📝 Delete one persisted dashboard validation report from health summary.
- 🔗 CALLS ->
backend.src.services.health_service.HealthService
- 📦 backend.src.api.routes.environments (
Module)- 📝 API endpoints for listing environments and their databases.
- 🏗️ Layer: API
- 🔒 Invariant: Environment IDs must exist in the configuration.
- 🔗 DEPENDS_ON ->
backend.src.dependencies - 🔗 DEPENDS_ON ->
backend.src.core.superset_client - ƒ _normalize_superset_env_url (
Function)[TRIVIAL]- 📝 Canonicalize Superset environment URL to base host/path without trailing /api/v1.
- 📦 ScheduleSchema (
DataClass)[TRIVIAL] - 📦 EnvironmentResponse (
DataClass)[TRIVIAL] - 📦 DatabaseResponse (
DataClass)[TRIVIAL] - ƒ get_environments (
Function)[TRIVIAL]- 📝 List all configured environments.
- 🏗️ Layer: API
- ƒ update_environment_schedule (
Function)[TRIVIAL]- 📝 Update backup schedule for an environment.
- 🏗️ Layer: API
- ƒ get_environment_databases (
Function)[TRIVIAL]- 📝 Fetch the list of databases from a specific environment.
- 🏗️ Layer: API
- 📦 backend.src.api.routes.migration (
Module)[CRITICAL]- 📝 HTTP contract layer for migration orchestration, settings, dry-run, and mapping sync endpoints.
- 🏗️ Layer: Infra
- 🔒 Invariant: Migration endpoints never execute with invalid environment references and always return explicit HTTP errors on guard failures.
- 🔗 DEPENDS_ON ->
backend.src.dependencies - 🔗 DEPENDS_ON ->
backend.src.core.database - 🔗 DEPENDS_ON ->
backend.src.core.superset_client.SupersetClient - 🔗 DEPENDS_ON ->
backend.src.core.migration.dry_run_orchestrator.MigrationDryRunService - 🔗 DEPENDS_ON ->
backend.src.core.mapping_service.IdMappingService - 🔗 DEPENDS_ON ->
backend.src.models.dashboard - 🔗 DEPENDS_ON ->
backend.src.models.mapping - ƒ get_dashboards (
Function)- 📝 Fetch dashboard metadata from a requested environment for migration selection UI.
- ƒ execute_migration (
Function)[CRITICAL]- 📝 Validate migration selection and enqueue asynchronous migration task execution.
- ƒ dry_run_migration (
Function)[CRITICAL]- 📝 Build pre-flight migration diff and risk summary without mutating target systems.
- ƒ get_migration_settings (
Function)- 📝 Read and return configured migration synchronization cron expression.
- ƒ update_migration_settings (
Function)- 📝 Validate and persist migration synchronization cron expression update.
- ƒ get_resource_mappings (
Function)- 📝 Fetch synchronized resource mappings with optional filters and pagination for migration mappings view.
- ƒ trigger_sync_now (
Function)- 📝 Trigger immediate ID synchronization for every configured environment.
- 📦 PluginsRouter (
Module)- 📝 Defines the FastAPI router for plugin-related endpoints, allowing clients to list available plugins.
- 🏗️ Layer: UI (API)
- ƒ list_plugins (
Function)[TRIVIAL]- 📝 Retrieve a list of all available plugins.
- 📦 backend.src.api.routes.clean_release_v2 (
Module)- 📝 Redesigned clean release API for headless candidate lifecycle.
- 🏗️ Layer: API
- ƒ register_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ import_artifacts (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ build_manifest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ approve_candidate_endpoint (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ reject_candidate_endpoint (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ publish_candidate_endpoint (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ revoke_publication_endpoint (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.mappings (
Module)- 📝 API endpoints for managing database mappings and getting suggestions.
- 🏗️ Layer: API
- 🔒 Invariant: Mappings are persisted in the SQLite database.
- 🔗 DEPENDS_ON ->
backend.src.dependencies - 🔗 DEPENDS_ON ->
backend.src.core.database - 🔗 DEPENDS_ON ->
backend.src.services.mapping_service - 📦 MappingCreate (
DataClass)[TRIVIAL] - 📦 MappingResponse (
DataClass)[TRIVIAL] - 📦 SuggestRequest (
DataClass)[TRIVIAL] - ƒ get_mappings (
Function)[TRIVIAL]- 📝 List all saved database mappings.
- ƒ create_mapping (
Function)[TRIVIAL]- 📝 Create or update a database mapping.
- ƒ suggest_mappings_api (
Function)[TRIVIAL]- 📝 Get suggested mappings based on fuzzy matching.
- 📦 SettingsRouter (
Module)- 📝 Provides API endpoints for managing application settings and Superset environments.
- 🏗️ Layer: UI (API)
- 🔒 Invariant: All settings changes must be persisted via ConfigManager.
- 🔗 DEPENDS_ON ->
backend.src.core.config_manager.ConfigManager - 🔗 DEPENDS_ON ->
backend.src.core.config_models - ℂ LoggingConfigResponse (
Class)[TRIVIAL]- 📝 Response model for logging configuration with current task log level.
- ƒ _normalize_superset_env_url (
Function)[TRIVIAL]- 📝 Canonicalize Superset environment URL to base host/path without trailing /api/v1.
- ƒ _validate_superset_connection_fast (
Function)- 📝 Run lightweight Superset connectivity validation without full pagination scan.
- ƒ get_settings (
Function)- 📝 Retrieves all application settings.
- ƒ update_global_settings (
Function)- 📝 Updates global application settings.
- ƒ get_storage_settings (
Function)- 📝 Retrieves storage-specific settings.
- ƒ update_storage_settings (
Function)- 📝 Updates storage-specific settings.
- ƒ get_environments (
Function)- 📝 Lists all configured Superset environments.
- ƒ add_environment (
Function)- 📝 Adds a new Superset environment.
- ƒ update_environment (
Function)- 📝 Updates an existing Superset environment.
- ƒ delete_environment (
Function)- 📝 Deletes a Superset environment.
- ƒ test_environment_connection (
Function)- 📝 Tests the connection to a Superset environment.
- ƒ get_logging_config (
Function)- 📝 Retrieves current logging configuration.
- ƒ update_logging_config (
Function)- 📝 Updates logging configuration.
- ℂ ConsolidatedSettingsResponse (
Class)[TRIVIAL]- 📝 Response model for consolidated application settings.
- ƒ get_consolidated_settings (
Function)- 📝 Retrieves all settings categories in a single call
- ƒ update_consolidated_settings (
Function)- 📝 Bulk update application settings from the consolidated view.
- ƒ get_validation_policies (
Function)- 📝 Lists all validation policies.
- ƒ create_validation_policy (
Function)- 📝 Creates a new validation policy.
- ƒ update_validation_policy (
Function)- 📝 Updates an existing validation policy.
- ƒ delete_validation_policy (
Function)- 📝 Deletes a validation policy.
- 📦 backend.src.api.routes.admin (
Module)- 📝 Admin API endpoints for user and role management.
- 🏗️ Layer: API
- 🔒 Invariant: All endpoints in this module require 'Admin' role or 'admin' scope.
- 📦 router (
Variable)[TRIVIAL]- 📝 APIRouter instance for admin routes.
- ƒ list_users (
Function)- 📝 Lists all registered users.
- ƒ create_user (
Function)- 📝 Creates a new local user.
- ƒ update_user (
Function)- 📝 Updates an existing user.
- ƒ delete_user (
Function)- 📝 Deletes a user.
- ƒ list_roles (
Function)- 📝 Lists all available roles.
- 🔗 CALLS ->
backend.src.models.auth.Role
- ƒ create_role (
Function)- 📝 Creates a new system role with associated permissions.
- 🔗 CALLS ->
backend.src.core.auth.repository.AuthRepository.get_permission_by_id
- ƒ update_role (
Function)- 📝 Updates an existing role's metadata and permissions.
- 🔗 CALLS ->
backend.src.core.auth.repository.AuthRepository.get_role_by_id
- ƒ delete_role (
Function)- 📝 Removes a role from the system.
- 🔗 CALLS ->
backend.src.core.auth.repository.AuthRepository.get_role_by_id
- ƒ list_permissions (
Function)- 📝 Lists all available system permissions for assignment.
- 🔗 CALLS ->
backend.src.core.auth.repository.AuthRepository.list_permissions
- ƒ list_ad_mappings (
Function)- 📝 Lists all AD Group to Role mappings.
- ƒ create_ad_mapping (
Function)- 📝 Creates a new AD Group mapping.
- 📦 backend.src.api.routes.git_schemas (
Module)- 📝 Defines Pydantic models for the Git integration API layer.
- 🏗️ Layer: API
- 🔒 Invariant: All schemas must be compatible with the FastAPI router.
- 🔗 DEPENDS_ON ->
backend.src.models.git - ℂ GitServerConfigBase (
Class)[TRIVIAL]- 📝 Base schema for Git server configuration attributes.
- ℂ GitServerConfigUpdate (
Class)[TRIVIAL]- 📝 Schema for updating an existing Git server configuration.
- ℂ GitServerConfigCreate (
Class)[TRIVIAL]- 📝 Schema for creating a new Git server configuration.
- ℂ GitServerConfigSchema (
Class)[TRIVIAL]- 📝 Schema for representing a Git server configuration with metadata.
- ℂ GitRepositorySchema (
Class)[TRIVIAL]- 📝 Schema for tracking a local Git repository linked to a dashboard.
- ℂ BranchSchema (
Class)[TRIVIAL]- 📝 Schema for representing a Git branch metadata.
- ℂ CommitSchema (
Class)[TRIVIAL]- 📝 Schema for representing Git commit details.
- ℂ BranchCreate (
Class)[TRIVIAL]- 📝 Schema for branch creation requests.
- ℂ BranchCheckout (
Class)[TRIVIAL]- 📝 Schema for branch checkout requests.
- ℂ CommitCreate (
Class)[TRIVIAL]- 📝 Schema for staging and committing changes.
- ℂ ConflictResolution (
Class)[TRIVIAL]- 📝 Schema for resolving merge conflicts.
- ℂ MergeStatusSchema (
Class)[TRIVIAL]- 📝 Schema representing unfinished merge status for repository.
- ℂ MergeConflictFileSchema (
Class)[TRIVIAL]- 📝 Schema describing one conflicted file with optional side snapshots.
- ℂ MergeResolveRequest (
Class)[TRIVIAL]- 📝 Request schema for resolving one or multiple merge conflicts.
- ℂ MergeContinueRequest (
Class)[TRIVIAL]- 📝 Request schema for finishing merge with optional explicit commit message.
- ℂ DeploymentEnvironmentSchema (
Class)[TRIVIAL]- 📝 Schema for representing a target deployment environment.
- ℂ DeployRequest (
Class)[TRIVIAL]- 📝 Schema for dashboard deployment requests.
- ℂ RepoInitRequest (
Class)[TRIVIAL]- 📝 Schema for repository initialization requests.
- ℂ RepositoryBindingSchema (
Class)[TRIVIAL]- 📝 Schema describing repository-to-config binding and provider metadata.
- ℂ RepoStatusBatchRequest (
Class)[TRIVIAL]- 📝 Schema for requesting repository statuses for multiple dashboards in a single call.
- ℂ RepoStatusBatchResponse (
Class)[TRIVIAL]- 📝 Schema for returning repository statuses keyed by dashboard ID.
- ℂ GiteaRepoSchema (
Class)[TRIVIAL]- 📝 Schema describing a Gitea repository.
- ℂ GiteaRepoCreateRequest (
Class)[TRIVIAL]- 📝 Request schema for creating a Gitea repository.
- ℂ RemoteRepoSchema (
Class)[TRIVIAL]- 📝 Provider-agnostic remote repository payload.
- ℂ RemoteRepoCreateRequest (
Class)[TRIVIAL]- 📝 Provider-agnostic repository creation request.
- ℂ PromoteRequest (
Class)[TRIVIAL]- 📝 Request schema for branch promotion workflow.
- ℂ PromoteResponse (
Class)[TRIVIAL]- 📝 Response schema for promotion operation result.
- 📦 backend.src.api.routes.assistant (
Module)- 📝 API routes for LLM assistant command parsing and safe execution orchestration.
- 🏗️ Layer: API
- 🔒 Invariant: Risky operations are never executed without valid confirmation token.
- 🔗 DEPENDS_ON ->
backend.src.core.task_manager.manager.TaskManager - 🔗 DEPENDS_ON ->
backend.src.models.assistant - ℂ AssistantMessageRequest (
Class)[TRIVIAL]- 📝 Input payload for assistant message endpoint.
- ℂ AssistantAction (
Class)[TRIVIAL]- 📝 UI action descriptor returned with assistant responses.
- ℂ AssistantMessageResponse (
Class)- 📝 Output payload contract for assistant interaction endpoints.
- ℂ ConfirmationRecord (
Class)- 📝 In-memory confirmation token model for risky operation dispatch.
- ƒ _append_history (
Function)- 📝 Append conversation message to in-memory history buffer.
- ƒ _persist_message (
Function)- 📝 Persist assistant/user message record to database.
- ƒ _audit (
Function)- 📝 Append in-memory audit record for assistant decision trace.
- ƒ _persist_audit (
Function)- 📝 Persist structured assistant audit payload in database.
- ƒ _persist_confirmation (
Function)- 📝 Persist confirmation token record to database.
- ƒ _update_confirmation_state (
Function)- 📝 Update persistent confirmation token lifecycle state.
- ƒ _load_confirmation_from_db (
Function)- 📝 Load confirmation token from database into in-memory model.
- ƒ _ensure_conversation (
Function)- 📝 Resolve active conversation id in memory or create a new one.
- ƒ _resolve_or_create_conversation (
Function)- 📝 Resolve active conversation using explicit id, memory cache, or persisted history.
- ƒ _cleanup_history_ttl (
Function)- 📝 Enforce assistant message retention window by deleting expired rows and in-memory records.
- ƒ _is_conversation_archived (
Function)- 📝 Determine archived state for a conversation based on last update timestamp.
- ƒ _coerce_query_bool (
Function)- 📝 Normalize bool-like query values for compatibility in direct handler invocations/tests.
- ƒ _extract_id (
Function)- 📝 Extract first regex match group from text by ordered pattern list.
- ƒ _resolve_env_id (
Function)- 📝 Resolve environment identifier/name token to canonical environment id.
- ƒ _is_production_env (
Function)- 📝 Determine whether environment token resolves to production-like target.
- ƒ _resolve_provider_id (
Function)- 📝 Resolve provider token to provider id with active/default fallback.
- ƒ _get_default_environment_id (
Function)- 📝 Resolve default environment id from settings or first configured environment.
- ƒ _resolve_dashboard_id_by_ref (
Function)- 📝 Resolve dashboard id by title or slug reference in selected environment.
- ƒ _resolve_dashboard_id_entity (
Function)- 📝 Resolve dashboard id from intent entities using numeric id or dashboard_ref fallback.
- ƒ _get_environment_name_by_id (
Function)- 📝 Resolve human-readable environment name by id.
- ƒ _extract_result_deep_links (
Function)- 📝 Build deep-link actions to verify task result from assistant chat.
- ƒ _build_task_observability_summary (
Function)- 📝 Build compact textual summary for completed tasks to reduce "black box" effect.
- ƒ _parse_command (
Function)- 📝 Deterministically parse RU/EN command text into intent payload.
- ƒ _check_any_permission (
Function)- 📝 Validate user against alternative permission checks (logical OR).
- ƒ _has_any_permission (
Function)- 📝 Check whether user has at least one permission tuple from the provided list.
- ƒ _build_tool_catalog (
Function)- 📝 Build current-user tool catalog for LLM planner with operation contracts and defaults.
- ƒ _coerce_intent_entities (
Function)- 📝 Normalize intent entity value types from LLM output to route-compatible values.
- ƒ _confirmation_summary (
Function)- 📝 Build human-readable confirmation prompt for an intent before execution.
- ƒ _clarification_text_for_intent (
Function)- 📝 Convert technical missing-parameter errors into user-facing clarification prompts.
- ƒ _plan_intent_with_llm (
Function)- 📝 Use active LLM provider to select best tool/operation from dynamic catalog.
- ƒ _authorize_intent (
Function)- 📝 Validate user permissions for parsed intent before confirmation/dispatch.
- ƒ _dispatch_intent (
Function)- 📝 Execute parsed assistant intent via existing task/plugin/git services.
- ƒ send_message (
Function)- 📝 Parse assistant command, enforce safety gates, and dispatch executable intent.
- ƒ confirm_operation (
Function)- 📝 Execute previously requested risky operation after explicit user confirmation.
- ƒ cancel_operation (
Function)- 📝 Cancel pending risky operation and mark confirmation token as cancelled.
- ƒ list_conversations (
Function)- 📝 Return paginated conversation list for current user with archived flag and last message preview.
- ƒ delete_conversation (
Function)- 📝 Soft-delete or hard-delete a conversation and clear its in-memory trace.
- ƒ get_history (
Function)[TRIVIAL]- 📝 Retrieve paginated assistant conversation history for current user.
- ƒ get_assistant_audit (
Function)[TRIVIAL]- 📝 Return assistant audit decisions for current user from persistent and in-memory stores.
- ƒ _async_confirmation_summary (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _label (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 storage_routes (
Module)- 📝 API endpoints for file storage management (backups and repositories).
- 🏗️ Layer: API
- 🔒 Invariant: All paths must be validated against path traversal.
- 🔗 DEPENDS_ON ->
backend.src.models.storage - ƒ list_files (
Function)- 📝 List all files and directories in the storage system.
- 🔗 CALLS ->
backend.src.plugins.storage.plugin.StoragePlugin.list_files
- ƒ upload_file (
Function)- 📝 Upload a file to the storage system.
- 🔗 CALLS ->
backend.src.plugins.storage.plugin.StoragePlugin.save_file
- ƒ delete_file (
Function)- 📝 Delete a specific file or directory.
- 🔗 CALLS ->
backend.src.plugins.storage.plugin.StoragePlugin.delete_file
- ƒ download_file (
Function)- 📝 Retrieve a file for download.
- 🔗 CALLS ->
backend.src.plugins.storage.plugin.StoragePlugin.get_file_path
- ƒ get_file_by_path (
Function)- 📝 Retrieve a file by validated absolute/relative path under storage root.
- 🔗 CALLS ->
backend.src.plugins.storage.plugin.StoragePlugin.get_storage_root - 🔗 CALLS ->
backend.src.plugins.storage.plugin.StoragePlugin.validate_path
- 📦 backend.src.api.routes.clean_release (
Module)- 📝 Expose clean release endpoints for candidate preparation and subsequent compliance flow.
- 🏗️ Layer: API
- 🔒 Invariant: API never reports prepared status if preparation errors are present.
- 🔗 DEPENDS_ON ->
backend.src.dependencies.get_clean_release_repository - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.preparation_service - ℂ PrepareCandidateRequest (
Class)[TRIVIAL]- 📝 Request schema for candidate preparation endpoint.
- ℂ StartCheckRequest (
Class)[TRIVIAL]- 📝 Request schema for clean compliance check run startup.
- ℂ RegisterCandidateRequest (
Class)[TRIVIAL]- 📝 Request schema for candidate registration endpoint.
- ℂ ImportArtifactsRequest (
Class)[TRIVIAL]- 📝 Request schema for candidate artifact import endpoint.
- ℂ BuildManifestRequest (
Class)[TRIVIAL]- 📝 Request schema for manifest build endpoint.
- ℂ CreateComplianceRunRequest (
Class)[TRIVIAL]- 📝 Request schema for compliance run creation with optional manifest pinning.
- ƒ register_candidate_v2_endpoint (
Function)[TRIVIAL]- 📝 Register a clean-release candidate for headless lifecycle.
- ƒ import_candidate_artifacts_v2_endpoint (
Function)[TRIVIAL]- 📝 Import candidate artifacts in headless flow.
- ƒ build_candidate_manifest_v2_endpoint (
Function)[TRIVIAL]- 📝 Build immutable manifest snapshot for prepared candidate.
- ƒ get_candidate_overview_v2_endpoint (
Function)[TRIVIAL]- 📝 Return expanded candidate overview DTO for headless lifecycle visibility.
- ƒ prepare_candidate_endpoint (
Function)[TRIVIAL]- 📝 Prepare candidate with policy evaluation and deterministic manifest generation.
- ƒ start_check (
Function)[TRIVIAL]- 📝 Start and finalize a clean compliance check run and persist report artifacts.
- ƒ get_check_status (
Function)[TRIVIAL]- 📝 Return terminal/intermediate status payload for a check run.
- ƒ get_report (
Function)[TRIVIAL]- 📝 Return persisted compliance report by report_id.
- 📦 ReportsRouter (
Module)[CRITICAL]- 📝 FastAPI router for unified task report list and detail retrieval endpoints.
- 🏗️ Layer: UI (API)
- 🔒 Invariant: Endpoints are read-only and do not trigger long-running tasks.
- 🔗 DEPENDS_ON ->
backend.src.services.reports.report_service.ReportsService - 🔗 DEPENDS_ON ->
backend.src.dependencies - ƒ _parse_csv_enum_list (
Function)[TRIVIAL]- 📝 Parse comma-separated query value into enum list.
- ƒ list_reports (
Function)- 📝 Return paginated unified reports list.
- ƒ get_report_detail (
Function)- 📝 Return one normalized report detail with diagnostics and next actions.
- 📦 backend.src.api.routes.profile (
Module)[CRITICAL]- 📝 Exposes self-scoped profile preference endpoints and environment-based Superset account lookup.
- 🏗️ Layer: API
- 🔒 Invariant: Endpoints are self-scoped and never mutate another user preference.
- 🔗 DEPENDS_ON ->
backend.src.services.profile_service - 🔗 DEPENDS_ON ->
backend.src.dependencies.get_current_user - 🔗 DEPENDS_ON ->
backend.src.core.database.get_db - ƒ _get_profile_service (
Function)[TRIVIAL]- 📝 Build profile service for current request scope.
- ƒ get_preferences (
Function)[TRIVIAL]- 📝 Get authenticated user's dashboard filter preference.
- ƒ update_preferences (
Function)[TRIVIAL]- 📝 Update authenticated user's dashboard filter preference.
- ƒ lookup_superset_accounts (
Function)[TRIVIAL]- 📝 Lookup Superset account candidates in selected environment.
- 📦 backend.src.api.routes.init (
Module)- 📝 Provide lazy route module loading to avoid heavyweight imports during tests.
- 🏗️ Layer: API
- 🔒 Invariant: Only names listed in all are importable via getattr.
- 🔗 DEPENDS_ON ->
importlib - ƒ getattr (
Function)[TRIVIAL]- 📝 Lazily import route module by attribute name.
- 📦 TasksRouter (
Module)- 📝 Defines the FastAPI router for task-related endpoints, allowing clients to create, list, and get the status of tasks.
- 🏗️ Layer: UI (API)
- 🔗 DEPENDS_ON ->
backend.src.core.task_manager.manager.TaskManager - 🔗 DEPENDS_ON ->
backend.src.core.config_manager.ConfigManager - 🔗 DEPENDS_ON ->
backend.src.services.llm_provider.LLMProviderService - ƒ create_task (
Function)- 📝 Create and start a new task for a given plugin.
- ƒ list_tasks (
Function)- 📝 Retrieve a list of tasks with pagination and optional status filter.
- ƒ get_task (
Function)- 📝 Retrieve the details of a specific task.
- ƒ get_task_logs (
Function)[CRITICAL]- 📝 Retrieve logs for a specific task with optional filtering.
- ƒ get_task_log_stats (
Function)- 📝 Get statistics about logs for a task (counts by level and source).
- ƒ get_task_log_sources (
Function)- 📝 Get unique sources for a task's logs.
- ƒ resolve_task (
Function)- 📝 Resolve a task that is awaiting mapping.
- ƒ resume_task (
Function)- 📝 Resume a task that is awaiting input (e.g., passwords).
- ƒ clear_tasks (
Function)- 📝 Clear tasks matching the status filter.
- 📦 backend.src.api.routes.dashboards (
Module)[CRITICAL]- 📝 API endpoints for the Dashboard Hub - listing dashboards with Git and task status
- 🏗️ Layer: API
- 🔒 Invariant: All dashboard responses include git_status and last_task metadata
- 🔗 DEPENDS_ON ->
backend.src.dependencies - 🔗 DEPENDS_ON ->
backend.src.services.resource_service.ResourceService - 🔗 DEPENDS_ON ->
backend.src.core.superset_client.SupersetClient - 📦 GitStatus (
DataClass)- 📝 DTO for dashboard Git synchronization status.
- 📦 LastTask (
DataClass)- 📝 DTO for the most recent background task associated with a dashboard.
- 📦 DashboardItem (
DataClass)- 📝 DTO representing a single dashboard with projected metadata.
- 📦 EffectiveProfileFilter (
DataClass)- 📝 Metadata about applied profile filters for UI context.
- 📦 DashboardsResponse (
DataClass)- 📝 Envelope DTO for paginated dashboards list.
- 📦 DashboardChartItem (
DataClass)- 📝 DTO for a chart linked to a dashboard.
- 📦 DashboardDatasetItem (
DataClass)- 📝 DTO for a dataset associated with a dashboard.
- 📦 DashboardDetailResponse (
DataClass)- 📝 Detailed dashboard metadata including children.
- 📦 DashboardTaskHistoryItem (
DataClass)- 📝 Individual history record entry.
- 📦 DashboardTaskHistoryResponse (
DataClass)- 📝 Collection DTO for task history.
- 📦 DatabaseMapping (
DataClass)- 📝 DTO for cross-environment database ID mapping.
- 📦 DatabaseMappingsResponse (
DataClass)- 📝 Wrapper for database mappings.
- ƒ _find_dashboard_id_by_slug (
Function)- 📝 Resolve dashboard numeric ID by slug using Superset list endpoint.
- ƒ _resolve_dashboard_id_from_ref (
Function)- 📝 Resolve dashboard ID from slug-first reference with numeric fallback.
- ƒ _find_dashboard_id_by_slug_async (
Function)- 📝 Resolve dashboard numeric ID by slug using async Superset list endpoint.
- ƒ _resolve_dashboard_id_from_ref_async (
Function)- 📝 Resolve dashboard ID from slug-first reference using async Superset client.
- ƒ _normalize_filter_values (
Function)- 📝 Normalize query filter values to lower-cased non-empty tokens.
- ƒ _dashboard_git_filter_value (
Function)- 📝 Build comparable git status token for dashboards filtering.
- ƒ _normalize_actor_alias_token (
Function)- 📝 Normalize actor alias token to comparable trim+lower text.
- ƒ _normalize_owner_display_token (
Function)- 📝 Project owner payload value into stable display string for API response contracts.
- ƒ _normalize_dashboard_owner_values (
Function)- 📝 Normalize dashboard owners payload to optional list of display strings.
- ƒ _project_dashboard_response_items (
Function)- 📝 Project dashboard payloads to response-contract-safe shape.
- ƒ _resolve_profile_actor_aliases (
Function)- 📝 Resolve stable actor aliases for profile filtering without per-dashboard detail fan-out.
- ƒ _matches_dashboard_actor_aliases (
Function)- 📝 Apply profile actor matching against multiple aliases (username + optional display name).
- ƒ get_dashboards (
Function)- 📝 Fetch list of dashboards from a specific environment with Git status and last task status
- 🔗 CALLS ->
get_dashboards_with_status
- ƒ get_database_mappings (
Function)- 📝 Get database mapping suggestions between source and target environments
- 🔗 CALLS ->
MappingService:get_suggestions
- ƒ get_dashboard_detail (
Function)- 📝 Fetch detailed dashboard info with related charts and datasets
- 🔗 CALLS ->
backend.src.core.async_superset_client.AsyncSupersetClient.get_dashboard_detail_async
- ƒ _task_matches_dashboard (
Function)- 📝 Checks whether task params are tied to a specific dashboard and environment.
- ƒ get_dashboard_tasks_history (
Function)- 📝 Returns history of backup and LLM validation tasks for a dashboard.
- ƒ get_dashboard_thumbnail (
Function)- 📝 Proxies Superset dashboard thumbnail with cache support.
- 📦 MigrateRequest (
DataClass)- 📝 DTO for dashboard migration requests.
- 📦 TaskResponse (
DataClass)- 📝 DTO for async task ID return.
- ƒ migrate_dashboards (
Function)- 📝 Trigger bulk migration of dashboards from source to target environment
- 🔗 DISPATCHES ->
MigrationPlugin:execute - 🔗 CALLS ->
task_manager:create_task
- 📦 BackupRequest (
DataClass)- 📝 DTO for dashboard backup requests.
- ƒ backup_dashboards (
Function)- 📝 Trigger bulk backup of dashboards with optional cron schedule
- 🔗 DISPATCHES ->
BackupPlugin:execute - 🔗 CALLS ->
task_manager:create_task
- ƒ _matches_dashboard_filters (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _sort_key (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_dashboards (
Module)- 📝 Unit tests for Dashboards API endpoints
- 🏗️ Layer: API
- ƒ test_get_dashboards_success (
Function)[TRIVIAL] - ƒ test_get_dashboards_with_search (
Function)[TRIVIAL] - ƒ test_get_dashboards_empty (
Function)[TRIVIAL] - ƒ test_get_dashboards_superset_failure (
Function)[TRIVIAL] - ƒ test_get_dashboards_env_not_found (
Function)[TRIVIAL] - ƒ test_get_dashboards_invalid_pagination (
Function)[TRIVIAL] - ƒ test_get_dashboard_detail_success (
Function)[TRIVIAL] - ƒ test_get_dashboard_detail_env_not_found (
Function)[TRIVIAL] - ƒ test_migrate_dashboards_success (
Function)[TRIVIAL] - ƒ test_migrate_dashboards_no_ids (
Function)[TRIVIAL] - ƒ test_migrate_dashboards_env_not_found (
Function)[TRIVIAL] - ƒ test_backup_dashboards_success (
Function)[TRIVIAL] - ƒ test_backup_dashboards_env_not_found (
Function)[TRIVIAL] - ƒ test_get_database_mappings_success (
Function)[TRIVIAL] - ƒ test_get_database_mappings_env_not_found (
Function)[TRIVIAL] - ƒ test_get_dashboard_tasks_history_filters_success (
Function)[TRIVIAL] - ƒ test_get_dashboard_thumbnail_success (
Function)[TRIVIAL] - ƒ _build_profile_preference_stub (
Function)[TRIVIAL]- 📝 Creates profile preference payload stub for dashboards filter contract tests.
- ƒ _matches_actor_case_insensitive (
Function)[TRIVIAL]- 📝 Applies trim + case-insensitive owners OR modified_by matching used by route contract tests.
- ƒ test_get_dashboards_profile_filter_contract_owners_or_modified_by (
Function)[TRIVIAL] - ƒ test_get_dashboards_override_show_all_contract (
Function)[TRIVIAL] - ƒ test_get_dashboards_profile_filter_no_match_results_contract (
Function)[TRIVIAL] - ƒ test_get_dashboards_page_context_other_disables_profile_default (
Function)[TRIVIAL] - ƒ test_get_dashboards_profile_filter_matches_display_alias_without_detail_fanout (
Function)[TRIVIAL] - ƒ test_get_dashboards_profile_filter_matches_owner_object_payload_contract (
Function)[TRIVIAL] - ƒ mock_deps (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ mock_get_dashboards (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _network_request (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_git_status_route (
Module)- 📝 Validate status endpoint behavior for missing and error repository states.
- 🏗️ Layer: Domain (Tests)
- 🔗 CALLS ->
src.api.routes.git.get_repository_status - ƒ test_get_repository_status_returns_no_repo_payload_for_missing_repo (
Function)[TRIVIAL]- 📝 Ensure missing local repository is represented as NO_REPO payload instead of an API error.
- ƒ test_get_repository_status_propagates_non_404_http_exception (
Function)[TRIVIAL]- 📝 Ensure HTTP exceptions other than 404 are not masked.
- ƒ test_get_repository_diff_propagates_http_exception (
Function)[TRIVIAL]- 📝 Ensure diff endpoint preserves domain HTTP errors from GitService.
- ƒ test_get_history_wraps_unexpected_error_as_500 (
Function)[TRIVIAL]- 📝 Ensure non-HTTP exceptions in history endpoint become deterministic 500 errors.
- ƒ test_commit_changes_wraps_unexpected_error_as_500 (
Function)[TRIVIAL]- 📝 Ensure commit endpoint does not leak unexpected errors as 400.
- ƒ test_get_repository_status_batch_returns_mixed_statuses (
Function)[TRIVIAL]- 📝 Ensure batch endpoint returns per-dashboard statuses in one response.
- ƒ test_get_repository_status_batch_marks_item_as_error_on_service_failure (
Function)[TRIVIAL]- 📝 Ensure batch endpoint marks failed items as ERROR without failing entire request.
- ƒ test_get_repository_status_batch_deduplicates_and_truncates_ids (
Function)[TRIVIAL]- 📝 Ensure batch endpoint protects server from oversized payloads.
- ƒ test_commit_changes_applies_profile_identity_before_commit (
Function)[TRIVIAL]- 📝 Ensure commit route configures repository identity from profile preferences before commit call.
- ƒ test_pull_changes_applies_profile_identity_before_pull (
Function)[TRIVIAL]- 📝 Ensure pull route configures repository identity from profile preferences before pull call.
- ƒ test_get_merge_status_returns_service_payload (
Function)[TRIVIAL]- 📝 Ensure merge status route returns service payload as-is.
- ƒ test_resolve_merge_conflicts_passes_resolution_items_to_service (
Function)[TRIVIAL]- 📝 Ensure merge resolve route forwards parsed resolutions to service.
- ƒ test_abort_merge_calls_service_and_returns_result (
Function)[TRIVIAL]- 📝 Ensure abort route delegates to service.
- ƒ test_continue_merge_passes_message_and_returns_commit (
Function)[TRIVIAL]- 📝 Ensure continue route passes commit message to service.
- ƒ _get_repo_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _get_repo_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_diff (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_commit_history (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit_changes (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _get_repo_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _get_repo_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _get_repo_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ configure_identity (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit_changes (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ first (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ query (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ configure_identity (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ pull_changes (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ first (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ query (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_merge_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolve_merge_conflicts (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ dict (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ abort_merge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ continue_merge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.test_reports_openapi_conformance (
Module)- 📝 Validate implemented reports payload shape against OpenAPI-required top-level contract fields.
- 🏗️ Layer: Domain (Tests)
- 🔒 Invariant: List and detail payloads include required contract keys.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_all_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _admin_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_reports_list_openapi_required_keys (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_reports_detail_openapi_required_keys (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.api.routes.test_clean_release_source_policy (
Module)- 📝 Validate API behavior for source isolation violations in clean release preparation.
- 🏗️ Layer: Domain
- 🔒 Invariant: External endpoints must produce blocking violation entries.
- ƒ _repo_with_seed_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_prepare_candidate_blocks_external_source (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.api.routes.test_clean_release_api (
Module)- 📝 Contract tests for clean release checks and reports endpoints.
- 🏗️ Layer: Domain
- 🔒 Invariant: API returns deterministic payload shapes for checks and reports.
- ƒ _repo_with_seed_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_start_check_and_get_status_contract (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_report_not_found_returns_404 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_report_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_prepare_candidate_api_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_tasks_logs (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/api/routes/tests/test_tasks_logs.py
- 🏗️ Layer: Unknown
- ƒ client (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_task_logs_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_task_logs_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_task_logs_invalid_limit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_task_log_stats_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.test_reports_api (
Module)- 📝 Contract tests for GET /api/reports defaults, pagination, and filtering behavior.
- 🏗️ Layer: Domain (Tests)
- 🔒 Invariant: API response contract contains {items,total,page,page_size,has_next,applied_filters}.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_all_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _admin_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_reports_default_pagination_contract (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_reports_filter_and_pagination (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_reports_handles_mixed_naive_and_aware_datetimes (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_reports_invalid_filter_returns_400 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_datasets (
Module)- 📝 Unit tests for Datasets API endpoints
- 🏗️ Layer: API
- 🔒 Invariant: Endpoint contracts remain stable for success and validation failure paths.
- ƒ test_get_datasets_success (
Function)[TRIVIAL]- 📝 Validate successful datasets listing contract for an existing environment.
- ƒ test_get_datasets_env_not_found (
Function)[TRIVIAL] - ƒ test_get_datasets_invalid_pagination (
Function)[TRIVIAL] - ƒ test_map_columns_success (
Function)[TRIVIAL] - ƒ test_map_columns_invalid_source_type (
Function)[TRIVIAL] - ƒ test_generate_docs_success (
Function)[TRIVIAL] - ƒ test_map_columns_empty_ids (
Function)[TRIVIAL] - ƒ test_generate_docs_empty_ids (
Function)[TRIVIAL] - ƒ test_generate_docs_env_not_found (
Function)[TRIVIAL] - ƒ test_get_datasets_superset_failure (
Function)[TRIVIAL] - ƒ mock_deps (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_profile_api (
Module)- 📝 Verifies profile API route contracts for preference read/update and Superset account lookup.
- 🏗️ Layer: API
- ƒ mock_profile_route_dependencies (
Function)[TRIVIAL]- 📝 Provides deterministic dependency overrides for profile route tests.
- ƒ profile_route_deps_fixture (
Function)[TRIVIAL]- 📝 Pytest fixture wrapper for profile route dependency overrides.
- ƒ _build_preference_response (
Function)[TRIVIAL]- 📝 Builds stable profile preference response payload for route tests.
- ƒ test_get_profile_preferences_returns_self_payload (
Function)[TRIVIAL]- 📝 Verifies GET /api/profile/preferences returns stable self-scoped payload.
- ƒ test_patch_profile_preferences_success (
Function)[TRIVIAL]- 📝 Verifies PATCH /api/profile/preferences persists valid payload through route mapping.
- ƒ test_patch_profile_preferences_validation_error (
Function)[TRIVIAL]- 📝 Verifies route maps domain validation failure to HTTP 422 with actionable details.
- ƒ test_patch_profile_preferences_cross_user_denied (
Function)[TRIVIAL]- 📝 Verifies route maps domain authorization guard failure to HTTP 403.
- ƒ test_lookup_superset_accounts_success (
Function)[TRIVIAL]- 📝 Verifies lookup route returns success payload with normalized candidates.
- ƒ test_lookup_superset_accounts_env_not_found (
Function)[TRIVIAL]- 📝 Verifies lookup route maps missing environment to HTTP 404.
- 📦 backend.tests.test_reports_detail_api (
Module)- 📝 Contract tests for GET /api/reports/{report_id} detail endpoint behavior.
- 🏗️ Layer: Domain (Tests)
- 🔒 Invariant: Detail endpoint tests must keep deterministic assertions for success and not-found contracts.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_all_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _admin_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_report_detail_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_report_detail_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_clean_release_legacy_compat (
Module)- 📝 Compatibility tests for legacy clean-release API paths retained during v2 migration.
- 🏗️ Layer: Tests
- ƒ _seed_legacy_repo (
Function)[TRIVIAL]- 📝 Seed in-memory repository with minimum trusted data for legacy endpoint contracts.
- ƒ test_legacy_prepare_endpoint_still_available (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_legacy_checks_endpoints_still_available (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_clean_release_v2_api (
Module)- 📝 API contract tests for redesigned clean release endpoints.
- 🏗️ Layer: Domain
- ƒ test_candidate_registration_contract (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_artifact_import_contract (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_manifest_build_contract (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_assistant_authz (
Module)- 📝 Verify assistant confirmation ownership, expiration, and deny behavior for restricted users.
- 🏗️ Layer: UI (API Tests)
- 🔒 Invariant: Security-sensitive flows fail closed for unauthorized actors.
- 🔗 DEPENDS_ON ->
backend.src.api.routes.assistant - ƒ _run_async (
Function)[TRIVIAL]- 📝 Execute async endpoint handler in synchronous test context.
- ℂ _FakeTask (
Class)[TRIVIAL]- 📝 Lightweight task model used for assistant authz tests.
- ℂ _FakeTaskManager (
Class)[TRIVIAL]- 📝 Minimal task manager for deterministic operation creation and lookup.
- ℂ _FakeConfigManager (
Class)[TRIVIAL]- 📝 Provide deterministic environment aliases required by intent parsing.
- ƒ _admin_user (
Function)[TRIVIAL]- 📝 Build admin principal fixture.
- ƒ _other_admin_user (
Function)[TRIVIAL]- 📝 Build second admin principal fixture for ownership tests.
- ƒ _limited_user (
Function)[TRIVIAL]- 📝 Build limited principal without required assistant execution privileges.
- ℂ _FakeQuery (
Class)[TRIVIAL]- 📝 Minimal chainable query object for fake DB interactions.
- ℂ _FakeDb (
Class)[TRIVIAL]- 📝 In-memory session substitute for assistant route persistence calls.
- ƒ _clear_assistant_state (
Function)[TRIVIAL]- 📝 Reset assistant process-local state between test cases.
- ƒ test_confirmation_owner_mismatch_returns_403 (
Function)[TRIVIAL]- 📝 Confirm endpoint should reject requests from user that does not own the confirmation token.
- ƒ test_expired_confirmation_cannot_be_confirmed (
Function)[TRIVIAL]- 📝 Expired confirmation token should be rejected and not create task.
- ƒ test_limited_user_cannot_launch_restricted_operation (
Function)[TRIVIAL]- 📝 Limited user should receive denied state for privileged operation.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ create_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_environments (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ order_by (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ first (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ all (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ limit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ offset (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ count (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ add (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ merge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ query (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ rollback (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_clean_release_v2_release_api (
Module)- 📝 API contract test scaffolding for clean release approval and publication endpoints.
- 🏗️ Layer: Domain
- 🔗 IMPLEMENTS ->
clean_release_v2_release_api_contracts - ƒ _seed_candidate_and_passed_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_release_approve_and_publish_revoke_contract (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_release_reject_contract (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_connections_routes (
Module)- 📝 Verifies connection routes bootstrap their table before CRUD access.
- 🏗️ Layer: API
- ƒ db_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_list_connections_bootstraps_missing_table (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_connection_bootstraps_missing_table (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_git_api (
Module)[TRIVIAL]- 📝 API tests for Git configurations and repository operations.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ query (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ first (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ all (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ add (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ delete (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refresh (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_git_configs_masks_pat (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_git_config_persists_config (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_update_git_config_modifies_record (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ query (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ first (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ refresh (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_update_git_config_raises_404_if_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_delete_git_config_removes_record (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ query (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ first (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ delete (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_test_git_config_validates_connection_successfully (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_connection (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_test_git_config_fails_validation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_connection (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_list_gitea_repositories_returns_payload (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_gitea_repositories (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_list_gitea_repositories_rejects_non_gitea (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_remote_repository_creates_provider_repo (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ create_gitlab_repository (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_init_repository_initializes_and_saves_binding (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init_repo (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _get_repo_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_assistant_api (
Module)- 📝 Validate assistant API endpoint logic via direct async handler invocation.
- 🏗️ Layer: UI (API Tests)
- 🔒 Invariant: Every test clears assistant in-memory state before execution.
- 🔗 DEPENDS_ON ->
backend.src.api.routes.assistant - ƒ _run_async (
Function)[TRIVIAL]- 📝 Execute async endpoint handler in synchronous test context.
- ℂ _FakeTask (
Class)[TRIVIAL]- 📝 Lightweight task stub used by assistant API tests.
- ℂ _FakeTaskManager (
Class)[TRIVIAL]- 📝 Minimal async-compatible TaskManager fixture for deterministic test flows.
- ℂ _FakeConfigManager (
Class)[TRIVIAL]- 📝 Environment config fixture with dev/prod aliases for parser tests.
- ƒ _admin_user (
Function)[TRIVIAL]- 📝 Build admin principal fixture.
- ƒ _limited_user (
Function)[TRIVIAL]- 📝 Build non-admin principal fixture.
- ℂ _FakeQuery (
Class)[TRIVIAL]- 📝 Minimal chainable query object for fake SQLAlchemy-like DB behavior in tests.
- ℂ _FakeDb (
Class)[TRIVIAL]- 📝 In-memory fake database implementing subset of Session interface used by assistant routes.
- ƒ _clear_assistant_state (
Function)[TRIVIAL]- 📝 Reset in-memory assistant registries for isolation between tests.
- ƒ test_unknown_command_returns_needs_clarification (
Function)[TRIVIAL]- 📝 Unknown command should return clarification state and unknown intent.
- ƒ test_capabilities_question_returns_successful_help (
Function)[TRIVIAL]- 📝 Capability query should return deterministic help response, not clarification.
- ƒ test_non_admin_command_returns_denied (
Function)[TRIVIAL]- 📝 Non-admin user must receive denied state for privileged command.
- ƒ test_migration_to_prod_requires_confirmation_and_can_be_confirmed (
Function)[TRIVIAL]- 📝 Migration to prod must require confirmation and then start task after explicit confirm.
- ƒ test_status_query_returns_task_status (
Function)[TRIVIAL]- 📝 Task status command must surface current status text for existing task id.
- ƒ test_status_query_without_task_id_returns_latest_user_task (
Function)[TRIVIAL]- 📝 Status command without explicit task_id should resolve to latest task for current user.
- ƒ test_llm_validation_with_dashboard_ref_requires_confirmation (
Function)[TRIVIAL]- 📝 LLM validation with dashboard_ref should now require confirmation before dispatch.
- ƒ test_list_conversations_groups_by_conversation_and_marks_archived (
Function)[TRIVIAL]- 📝 Conversations endpoint must group messages and compute archived marker by inactivity threshold.
- ƒ test_history_from_latest_returns_recent_page_first (
Function)[TRIVIAL]- 📝 History endpoint from_latest mode must return newest page while preserving chronological order in chunk.
- ƒ test_list_conversations_archived_only_filters_active (
Function)[TRIVIAL]- 📝 archived_only mode must return only archived conversations.
- ƒ test_guarded_operation_always_requires_confirmation (
Function)[TRIVIAL]- 📝 Non-dangerous (guarded) commands must still require confirmation before execution.
- ƒ test_guarded_operation_confirm_roundtrip (
Function)[TRIVIAL]- 📝 Guarded operation must execute successfully after explicit confirmation.
- ƒ test_confirm_nonexistent_id_returns_404 (
Function)[TRIVIAL]- 📝 Confirming a non-existent ID should raise 404.
- ƒ test_migration_with_dry_run_includes_summary (
Function)[TRIVIAL]- 📝 Migration command with dry run flag must return the dry run summary in confirmation text.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ create_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_environments (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_config (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ order_by (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ first (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ all (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ count (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ offset (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ limit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ add (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ merge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ query (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ rollback (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.api.routes.tests.test_migration_routes (
Module)- 📝 Unit tests for migration API route handlers.
- 🏗️ Layer: API
- ƒ db_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_config_manager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_migration_settings_returns_default_cron (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_migration_settings_returns_fallback_when_no_cron (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_update_migration_settings_saves_cron (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_update_migration_settings_rejects_missing_cron (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_resource_mappings_returns_formatted_list (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_resource_mappings_respects_pagination (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_resource_mappings_search_by_name (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_resource_mappings_filter_by_env (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_resource_mappings_filter_by_type (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _mock_env (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_sync_config_manager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_trigger_sync_now_creates_env_row_and_syncs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_trigger_sync_now_rejects_empty_environments (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_trigger_sync_now_handles_partial_failure (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_trigger_sync_now_idempotent_env_upsert (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_invalid_env_raises_404 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_execute_migration_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_execute_migration_invalid_env_raises_400 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_dry_run_migration_returns_diff_and_risk (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_dry_run_migration_rejects_same_environment (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.models.config (
Module)[CRITICAL]- 📝 Defines SQLAlchemy persistence models for application and notification configuration records.
- 🏗️ Layer: Domain
- 🔒 Invariant: Configuration payload and notification credentials must remain persisted as non-null JSON documents.
- 🔗 DEPENDS_ON ->
sqlalchemy - 🔗 DEPENDS_ON ->
backend.src.models.mapping:Base - ℂ AppConfigRecord (
Class)[CRITICAL]- 📝 Stores persisted application configuration as a single authoritative record model.
- ℂ NotificationConfig (
Class)[CRITICAL]- 📝 Stores persisted provider-level notification configuration and encrypted credentials metadata.
- 📦 backend.src.models.llm (
Module)- 📝 SQLAlchemy models for LLM provider configuration and validation results.
- 🏗️ Layer: Domain
- ℂ ValidationPolicy (
Class)[TRIVIAL]- 📝 Defines a scheduled rule for validating a group of dashboards within an execution window.
- ℂ LLMProvider (
Class)[TRIVIAL]- 📝 SQLAlchemy model for LLM provider configuration.
- ℂ ValidationRecord (
Class)[TRIVIAL]- 📝 SQLAlchemy model for dashboard validation history.
- ƒ generate_uuid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 GitModels (
Module)[TRIVIAL]- 📝 Git-specific SQLAlchemy models for configuration and repository tracking.
- 🏗️ Layer: Model
- ℂ GitServerConfig (
Class)[TRIVIAL]- 📝 Configuration for a Git server connection.
- ℂ GitRepository (
Class)[TRIVIAL]- 📝 Tracking for a local Git repository linked to a dashboard.
- ℂ DeploymentEnvironment (
Class)[TRIVIAL]- 📝 Target Superset environments for dashboard deployment.
- 📦 backend.src.models.task (
Module)[TRIVIAL]- 📝 Defines the database schema for task execution records.
- 🏗️ Layer: Domain
- 🔒 Invariant: All primary keys are UUID strings.
- 🔗 DEPENDS_ON ->
sqlalchemy - ℂ TaskRecord (
Class)[TRIVIAL]- 📝 Represents a persistent record of a task execution.
- ℂ TaskLogRecord (
Class)[CRITICAL]- 📝 Represents a single persistent log entry for a task.
- 🔒 Invariant: Each log entry belongs to exactly one task.
- 🔗 DEPENDS_ON ->
TaskRecord
- 📦 backend.src.models.connection (
Module)[TRIVIAL]- 📝 Defines the database schema for external database connection configurations.
- 🏗️ Layer: Domain
- 🔒 Invariant: All primary keys are UUID strings.
- 🔗 DEPENDS_ON ->
sqlalchemy - ℂ ConnectionConfig (
Class)[TRIVIAL]- 📝 Stores credentials for external databases used for column mapping.
- 📦 backend.src.models.mapping (
Module)- 📝 Defines the database schema for environment metadata and database mappings using SQLAlchemy.
- 🏗️ Layer: Domain
- 🔒 Invariant: All primary keys are UUID strings.
- 🔗 DEPENDS_ON ->
sqlalchemy - ℂ ResourceType (
Class)[TRIVIAL]- 📝 Enumeration of possible Superset resource types for ID mapping.
- ℂ MigrationStatus (
Class)[TRIVIAL]- 📝 Enumeration of possible migration job statuses.
- ℂ Environment (
Class)- 📝 Represents a Superset instance environment.
- ℂ DatabaseMapping (
Class)- 📝 Represents a mapping between source and target databases.
- ℂ MigrationJob (
Class)[TRIVIAL]- 📝 Represents a single migration execution job.
- ℂ ResourceMapping (
Class)- 📝 Maps a universal UUID for a resource to its actual ID on a specific environment.
- 📦 backend.src.models.report (
Module)[CRITICAL]- 📝 Canonical report schemas for unified task reporting across heterogeneous task types.
- 🏗️ Layer: Domain
- 🔒 Invariant: Canonical report fields are always present for every report item.
- 🔗 DEPENDS_ON ->
backend.src.core.task_manager.models - ℂ TaskType (
Class)[CRITICAL]- 📝 Supported normalized task report types.
- 🔒 Invariant: Must contain valid generic task type mappings.
- ℂ ReportStatus (
Class)[CRITICAL]- 📝 Supported normalized report status values.
- 🔒 Invariant: TaskStatus enum mapping logic holds.
- ℂ ErrorContext (
Class)[CRITICAL]- 📝 Error and recovery context for failed/partial reports.
- 🔒 Invariant: The properties accurately describe error state.
- ℂ TaskReport (
Class)[CRITICAL]- 📝 Canonical normalized report envelope for one task execution.
- 🔒 Invariant: Must represent canonical task record attributes.
- ℂ ReportQuery (
Class)[CRITICAL]- 📝 Query object for server-side report filtering, sorting, and pagination.
- 🔒 Invariant: Time and pagination queries are mutually consistent.
- ℂ ReportCollection (
Class)[CRITICAL]- 📝 Paginated collection of normalized task reports.
- 🔒 Invariant: Represents paginated data correctly.
- ℂ ReportDetailView (
Class)[CRITICAL]- 📝 Detailed report representation including diagnostics and recovery actions.
- 🔒 Invariant: Incorporates a report and logs correctly.
- ƒ _non_empty_str (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _validate_sort_by (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _validate_sort_order (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _validate_time_range (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.models.assistant (
Module)- 📝 SQLAlchemy models for assistant audit trail and confirmation tokens.
- 🏗️ Layer: Domain
- 🔒 Invariant: Assistant records preserve immutable ids and creation timestamps.
- 🔗 DEPENDS_ON ->
backend.src.models.mapping - ℂ AssistantAuditRecord (
Class)- 📝 Store audit decisions and outcomes produced by assistant command handling.
- ℂ AssistantMessageRecord (
Class)- 📝 Persist chat history entries for assistant conversations.
- ℂ AssistantConfirmationRecord (
Class)- 📝 Persist risky operation confirmation tokens with lifecycle state.
- 📦 backend.src.models.storage (
Module)[TRIVIAL]- 📝 Data models for the storage system.
- 🏗️ Layer: Domain
- ℂ FileCategory (
Class)[TRIVIAL]- 📝 Enumeration of supported file categories in the storage system.
- ℂ StorageConfig (
Class)[TRIVIAL]- 📝 Configuration model for the storage system, defining paths and naming patterns.
- ℂ StoredFile (
Class)[TRIVIAL]- 📝 Data model representing metadata for a file stored in the system.
- 📦 backend.src.models.dashboard (
Module)- 📝 Defines data models for dashboard metadata and selection.
- 🏗️ Layer: Model
- ℂ DashboardMetadata (
Class)[TRIVIAL]- 📝 Represents a dashboard available for migration.
- ℂ DashboardSelection (
Class)[TRIVIAL]- 📝 Represents the user's selection of dashboards to migrate.
- 📦 backend.src.models.clean_release (
Module)[CRITICAL]- 📝 Define canonical clean release domain entities and lifecycle guards.
- 🏗️ Layer: Domain
- 🔒 Invariant: Immutable snapshots are never mutated; forbidden lifecycle transitions are rejected.
- ℂ CheckFinalStatus (
Class)[TRIVIAL]- 📝 Backward-compatible final status enum for legacy TUI/orchestrator tests.
- ℂ CheckStageName (
Class)[TRIVIAL]- 📝 Backward-compatible stage name enum for legacy TUI/orchestrator tests.
- ℂ CheckStageStatus (
Class)[TRIVIAL]- 📝 Backward-compatible stage status enum for legacy TUI/orchestrator tests.
- ℂ CheckStageResult (
Class)[TRIVIAL]- 📝 Backward-compatible stage result container for legacy TUI/orchestrator tests.
- ℂ ProfileType (
Class)[TRIVIAL]- 📝 Backward-compatible profile enum for legacy TUI bootstrap logic.
- ℂ RegistryStatus (
Class)[TRIVIAL]- 📝 Backward-compatible registry status enum for legacy TUI bootstrap logic.
- ℂ ReleaseCandidateStatus (
Class)[TRIVIAL]- 📝 Backward-compatible release candidate status enum for legacy TUI.
- ℂ ResourceSourceEntry (
Class)[TRIVIAL]- 📝 Backward-compatible source entry model for legacy TUI bootstrap logic.
- ℂ ResourceSourceRegistry (
Class)[TRIVIAL]- 📝 Backward-compatible source registry model for legacy TUI bootstrap logic.
- ℂ CleanProfilePolicy (
Class)[TRIVIAL]- 📝 Backward-compatible policy model for legacy TUI bootstrap logic.
- ℂ ComplianceCheckRun (
Class)[TRIVIAL]- 📝 Backward-compatible run model for legacy TUI typing/import compatibility.
- ℂ ReleaseCandidate (
Class)[TRIVIAL]- 📝 Represents the release unit being prepared and governed.
- ℂ CandidateArtifact (
Class)[TRIVIAL]- 📝 Represents one artifact associated with a release candidate.
- ℂ ManifestItem (
Class)[TRIVIAL] - ℂ ManifestSummary (
Class)[TRIVIAL] - ℂ DistributionManifest (
Class)[TRIVIAL]- 📝 Immutable snapshot of the candidate payload.
- 🔒 Invariant: Immutable after creation.
- ℂ SourceRegistrySnapshot (
Class)[TRIVIAL]- 📝 Immutable registry snapshot for allowed sources.
- ℂ CleanPolicySnapshot (
Class)[TRIVIAL]- 📝 Immutable policy snapshot used to evaluate a run.
- ℂ ComplianceRun (
Class)[TRIVIAL]- 📝 Operational record for one compliance execution.
- ℂ ComplianceStageRun (
Class)[TRIVIAL]- 📝 Stage-level execution record inside a run.
- ℂ ComplianceViolation (
Class)[TRIVIAL]- 📝 Violation produced by a stage.
- ℂ ComplianceReport (
Class)[TRIVIAL]- 📝 Immutable result derived from a completed run.
- 🔒 Invariant: Immutable after creation.
- ℂ ApprovalDecision (
Class)[TRIVIAL]- 📝 Approval or rejection bound to a candidate and report.
- ℂ PublicationRecord (
Class)[TRIVIAL]- 📝 Publication or revocation record.
- ℂ CleanReleaseAuditLog (
Class)[TRIVIAL]- 📝 Represents a persistent audit log entry for clean release actions.
- ƒ id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ registry_snapshot_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ candidate_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ transition_to (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ check_run_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.models.auth (
Module)- 📝 SQLAlchemy models for multi-user authentication and authorization.
- 🏗️ Layer: Domain
- 🔒 Invariant: Usernames and emails must be unique.
- ƒ generate_uuid (
Function)[TRIVIAL]- 📝 Generates a unique UUID string.
- 📦 user_roles (
Table)[TRIVIAL]- 📝 Association table for many-to-many relationship between Users and Roles.
- 📦 role_permissions (
Table)[TRIVIAL]- 📝 Association table for many-to-many relationship between Roles and Permissions.
- ℂ User (
Class)[CRITICAL]- 📝 Represents an identity that can authenticate to the system.
- ℂ Role (
Class)[CRITICAL]- 📝 Represents a collection of permissions.
- ℂ Permission (
Class)[CRITICAL]- 📝 Represents a specific capability within the system.
- ℂ ADGroupMapping (
Class)[CRITICAL]- 📝 Maps an Active Directory group to a local System Role.
- 🔗 DEPENDS_ON ->
Role
- 📦 backend.src.models.profile (
Module)- 📝 Defines persistent per-user profile settings for dashboard filter, Git identity/token, and UX preferences.
- 🏗️ Layer: Domain
- 🔒 Invariant: Sensitive Git token is stored encrypted and never returned in plaintext.
- 🔗 DEPENDS_ON ->
backend.src.models.auth - ℂ UserDashboardPreference (
Class)- 📝 Stores Superset username binding and default "my dashboards" toggle for one authenticated user.
- 📦 src.models (
Package)[TRIVIAL]- 📝 Domain model package root.
- 📦 test_models (
Module)[TRIVIAL]- 📝 Unit tests for data models
- 🏗️ Layer: Domain
- ƒ test_environment_model (
Function)[TRIVIAL]- 📝 Tests that Environment model correctly stores values.
- 📦 test_report_models (
Module)- 📝 Unit tests for report Pydantic models and their validators
- 🏗️ Layer: Domain
- ƒ test_enum_values (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_enum_values (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_valid_creation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_minimal_creation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_valid_creation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_empty_report_id_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_whitespace_report_id_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_empty_task_id_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_empty_summary_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_summary_whitespace_trimmed (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_optional_fields (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_with_error_context (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_defaults (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_invalid_sort_by_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_valid_sort_by_values (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_invalid_sort_order_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_valid_sort_order_values (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_time_range_validation_valid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_time_range_validation_invalid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_page_ge_1 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_page_size_bounds (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_valid_creation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_with_items (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_valid_creation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_with_all_fields (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_clean_release (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/models/tests/test_clean_release.py
- 🏗️ Layer: Unknown
- ƒ valid_candidate_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_release_candidate_valid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_release_candidate_empty_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ valid_policy_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_enterprise_policy_valid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_enterprise_policy_missing_prohibited (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_enterprise_policy_external_allowed (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_manifest_count_mismatch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_compliant_run_validation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_report_validation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.profile_service (
Module)[CRITICAL]- 📝 Orchestrates profile preference persistence, Superset account lookup, and deterministic actor matching.
- 🏗️ Layer: Domain
- 🔒 Invariant: Username normalization is trim+lower and shared by save and matching paths.
- 🔗 DEPENDS_ON ->
backend.src.models.profile - 🔗 DEPENDS_ON ->
backend.src.schemas.profile - 🔗 DEPENDS_ON ->
backend.src.core.superset_client - 🔗 DEPENDS_ON ->
backend.src.core.auth.repository - 🔗 DEPENDS_ON ->
backend.src.models.auth - 🔗 DEPENDS_ON ->
sqlalchemy.orm.Session - ℂ ProfileValidationError (
Class)- 📝 Domain validation error for profile preference update requests.
- ℂ EnvironmentNotFoundError (
Class)- 📝 Raised when environment_id from lookup request is unknown in app configuration.
- ℂ ProfileAuthorizationError (
Class)- 📝 Raised when caller attempts cross-user preference mutation.
- ℂ ProfileService (
Class)[CRITICAL]- 📝 Implements profile preference read/update flow and Superset account lookup degradation strategy.
- ƒ init (
Function)[TRIVIAL]- 📝 Initialize service with DB session and config manager.
- ƒ get_my_preference (
Function)[TRIVIAL]- 📝 Return current user's persisted preference or default non-configured view.
- ƒ get_dashboard_filter_binding (
Function)[TRIVIAL]- 📝 Return only dashboard-filter fields required by dashboards listing hot path.
- ƒ update_my_preference (
Function)[TRIVIAL]- 📝 Validate and persist current user's profile preference in self-scoped mode.
- ƒ lookup_superset_accounts (
Function)[TRIVIAL]- 📝 Query Superset users in selected environment and project canonical account candidates.
- ƒ matches_dashboard_actor (
Function)[TRIVIAL]- 📝 Apply trim+case-insensitive actor match across owners OR modified_by.
- ƒ _build_security_summary (
Function)[TRIVIAL]- 📝 Build read-only security snapshot with role and permission badges.
- ƒ _collect_user_permission_pairs (
Function)[TRIVIAL]- 📝 Collect effective permission tuples from current user's roles.
- ƒ _format_permission_key (
Function)[TRIVIAL]- 📝 Convert normalized permission pair to compact UI key.
- ƒ _to_preference_payload (
Function)[TRIVIAL]- 📝 Map ORM preference row to API DTO with token metadata.
- ƒ _mask_secret_value (
Function)[TRIVIAL]- 📝 Build a safe display value for sensitive secrets.
- ƒ _sanitize_text (
Function)[TRIVIAL]- 📝 Normalize optional text into trimmed form or None.
- ƒ _sanitize_secret (
Function)[TRIVIAL]- 📝 Normalize secret input into trimmed form or None.
- ƒ _normalize_start_page (
Function)[TRIVIAL]- 📝 Normalize supported start page aliases to canonical values.
- ƒ _normalize_density (
Function)[TRIVIAL]- 📝 Normalize supported density aliases to canonical values.
- ƒ _resolve_environment (
Function)[TRIVIAL]- 📝 Resolve environment model from configured environments by id.
- ƒ _get_preference_row (
Function)[TRIVIAL]- 📝 Return persisted preference row for user or None.
- ƒ _get_or_create_preference_row (
Function)[TRIVIAL]- 📝 Return existing preference row or create new unsaved row.
- ƒ _build_default_preference (
Function)[TRIVIAL]- 📝 Build non-persisted default preference DTO for unconfigured users.
- ƒ _validate_update_payload (
Function)[TRIVIAL]- 📝 Validate username/toggle constraints for preference mutation.
- ƒ _sanitize_username (
Function)[TRIVIAL]- 📝 Normalize raw username into trimmed form or None for empty input.
- ƒ _normalize_username (
Function)[TRIVIAL]- 📝 Apply deterministic trim+lower normalization for actor matching.
- ƒ _normalize_owner_tokens (
Function)[TRIVIAL]- 📝 Normalize owners payload into deduplicated lower-cased tokens.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.resource_service (
Module)- 📝 Shared service for fetching resource data with Git status and task status
- 🏗️ Layer: Service
- 🔒 Invariant: All resources include metadata about their current state
- 🔗 DEPENDS_ON ->
backend.src.core.superset_client.SupersetClient - 🔗 DEPENDS_ON ->
TaskManagerPackage - 🔗 DEPENDS_ON ->
TaskManagerModels - 🔗 DEPENDS_ON ->
backend.src.services.git_service.GitService - ℂ backend.src.services.resource_service.ResourceService (
Class)- 📝 Provides centralized access to resource data with enhanced metadata
- ƒ backend.src.services.resource_service.ResourceService.init (
Function)[TRIVIAL]- 📝 Initialize the resource service with dependencies
- ƒ backend.src.services.resource_service.ResourceService.get_dashboards_with_status (
Function)- 📝 Fetch dashboards from environment with Git status and last task status
- 🔗 CALLS ->
backend.src.core.superset_client.SupersetClient.get_dashboards_summary - 🔗 CALLS ->
backend.src.services.resource_service.ResourceService._get_git_status_for_dashboard - 🔗 CALLS ->
backend.src.services.resource_service.ResourceService._get_last_llm_task_for_dashboard - ƒ get_dashboards_page_with_status (
Function)- 📝 Fetch one dashboard page from environment and enrich only that page with status metadata.
- ƒ _get_last_llm_task_for_dashboard (
Function)- 📝 Get most recent LLM validation task for a dashboard in an environment
- ƒ _normalize_task_status (
Function)- 📝 Normalize task status to stable uppercase values for UI/API projections
- ƒ _normalize_validation_status (
Function)- 📝 Normalize LLM validation status to PASS/FAIL/WARN/UNKNOWN
- ƒ _normalize_datetime_for_compare (
Function)- 📝 Normalize datetime values to UTC-aware values for safe comparisons.
- ƒ get_datasets_with_status (
Function)- 📝 Fetch datasets from environment with mapping progress and last task status
- 🔗 CALLS ->
SupersetClient:get_datasets_summary - 🔗 CALLS ->
self:_get_last_task_for_resource
- ƒ get_activity_summary (
Function)- 📝 Get summary of active and recent tasks for the activity indicator
- ƒ _get_git_status_for_dashboard (
Function)- 📝 Get Git sync status for a dashboard
- 🔗 CALLS ->
GitService:get_repo
- ƒ _get_last_task_for_resource (
Function)- 📝 Get the most recent task for a specific resource
- ƒ _extract_resource_name_from_task (
Function)- 📝 Extract resource name from task params
- ƒ _extract_resource_type_from_task (
Function)- 📝 Extract resource type from task params
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_dashboards_with_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _task_time (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.llm_prompt_templates (
Module)- 📝 Provide default LLM prompt templates and normalization helpers for runtime usage.
- 🏗️ Layer: Domain
- 🔒 Invariant: All required prompt template keys are always present after normalization.
- 🔗 DEPENDS_ON ->
backend.src.core.config_manager - 📦 DEFAULT_LLM_PROMPTS (
Constant)- 📝 Default prompt templates used by documentation, dashboard validation, and git commit generation.
- 📦 DEFAULT_LLM_PROVIDER_BINDINGS (
Constant)- 📝 Default provider binding per task domain.
- 📦 DEFAULT_LLM_ASSISTANT_SETTINGS (
Constant)- 📝 Default planner settings for assistant chat intent model/provider resolution.
- ƒ normalize_llm_settings (
Function)- 📝 Ensure llm settings contain stable schema with prompts section and default templates.
- ƒ is_multimodal_model (
Function)- 📝 Heuristically determine whether model supports image input required for dashboard validation.
- ƒ resolve_bound_provider_id (
Function)- 📝 Resolve provider id configured for a task binding with fallback to default provider.
- ƒ render_prompt (
Function)- 📝 Render prompt template using deterministic placeholder replacement with graceful fallback.
- 📦 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 - ℂ HealthService (
Class)- 📝 Aggregate latest dashboard validation state and manage persisted health report lifecycle.
- 🔗 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 - ƒ HealthService.init (
Function)- 📝 Initialize health service with DB session and optional config access for dashboard metadata resolution.
- ƒ HealthService._prime_dashboard_meta_cache (
Function)- 📝 Warm dashboard slug/title cache with one Superset list fetch per environment.
- 🔗 CALLS ->
backend.src.core.superset_client.SupersetClient.get_dashboards_summary
- ƒ HealthService._resolve_dashboard_meta (
Function)[TRIVIAL]- 📝 Resolve slug/title for a dashboard referenced by persisted validation record.
- ƒ HealthService.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
- ƒ HealthService.delete_validation_report (
Function)- 📝 Delete one persisted health report and optionally clean linked task/log artifacts.
- 🔗 CALLS ->
backend.src.core.task_manager.cleanup.TaskCleanupService.delete_task_with_logs
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _prime_dashboard_meta_cache (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _resolve_dashboard_meta (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_health_summary (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ delete_validation_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.llm_provider (
Module)- 📝 Service for managing LLM provider configurations with encrypted API keys.
- 🏗️ Layer: Domain
- 🔗 DEPENDS_ON ->
backend.src.core.database - 🔗 DEPENDS_ON ->
backend.src.models.llm - ƒ _require_fernet_key (
Function)[CRITICAL]- 📝 Load and validate the Fernet key used for secret encryption.
- ℂ EncryptionManager (
Class)[CRITICAL]- 📝 Handles encryption and decryption of sensitive data like API keys.
- 🔒 Invariant: Uses only a validated secret key from environment.
- ƒ EncryptionManager.init (
Function)[TRIVIAL]- 📝 Initialize the encryption manager with a Fernet key.
- ƒ EncryptionManager.encrypt (
Function)[TRIVIAL]- 📝 Encrypt a plaintext string.
- ƒ EncryptionManager.decrypt (
Function)[TRIVIAL]- 📝 Decrypt an encrypted string.
- ℂ LLMProviderService (
Class)- 📝 Service to manage LLM provider lifecycle.
- ƒ LLMProviderService.init (
Function)[TRIVIAL]- 📝 Initialize the service with database session.
- ƒ get_all_providers (
Function)- 📝 Returns all configured LLM providers.
- ƒ get_provider (
Function)- 📝 Returns a single LLM provider by ID.
- ƒ create_provider (
Function)- 📝 Creates a new LLM provider with encrypted API key.
- ƒ update_provider (
Function)- 📝 Updates an existing LLM provider.
- ƒ delete_provider (
Function)- 📝 Deletes an LLM provider.
- ƒ get_decrypted_api_key (
Function)- 📝 Returns the decrypted API key for a provider.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ encrypt (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ decrypt (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.rbac_permission_catalog (
Module)- 📝 Discovers declared RBAC permissions from API routes/plugins and synchronizes them into auth database.
- 🏗️ Layer: Service
- 🔒 Invariant: Synchronization is idempotent for existing (resource, action) permission pairs.
- 🔗 CALLS ->
backend.src.core.plugin_loader.PluginLoader.get_all_plugin_configs - 🔗 DEPENDS_ON ->
backend.src.models.auth.Permission - 📦 HAS_PERMISSION_PATTERN (
Constant)[TRIVIAL]- 📝 Regex pattern for extracting has_permission("resource", "ACTION") declarations.
- 📦 ROUTES_DIR (
Constant)[TRIVIAL]- 📝 Absolute directory path where API route RBAC declarations are defined.
- ƒ _iter_route_files (
Function)[TRIVIAL]- 📝 Iterates API route files that may contain RBAC declarations.
- ƒ _discover_route_permissions (
Function)[TRIVIAL]- 📝 Extracts explicit has_permission declarations from API route source code.
- ƒ _discover_route_permissions_cached (
Function)[TRIVIAL]- 📝 Cache route permission discovery because route source files are static during normal runtime.
- ƒ _discover_plugin_execute_permissions (
Function)[TRIVIAL]- 📝 Derives dynamic task permissions of form plugin:{plugin_id}:EXECUTE from plugin registry.
- ƒ _discover_plugin_execute_permissions_cached (
Function)[TRIVIAL]- 📝 Cache dynamic plugin EXECUTE permission pairs by normalized plugin id tuple.
- ƒ discover_declared_permissions (
Function)[TRIVIAL]- 📝 Builds canonical RBAC permission catalog from routes and plugin registry.
- ƒ sync_permission_catalog (
Function)[TRIVIAL]- 📝 Persists missing RBAC permission pairs into auth database.
- 📦 backend.src.services (
Module)- 📝 Package initialization for services module
- 🏗️ Layer: Core
- ƒ getattr (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.auth_service (
Module)[CRITICAL]- 📝 Orchestrates credential authentication and ADFS JIT user provisioning.
- 🏗️ Layer: Domain
- 🔒 Invariant: Authentication succeeds only for active users with valid credentials; issued sessions encode subject and scopes from assigned roles.
- 🔗 DEPENDS_ON ->
backend.src.core.auth.repository.AuthRepository - 🔗 DEPENDS_ON ->
backend.src.core.auth.security.verify_password - 🔗 DEPENDS_ON ->
backend.src.core.auth.jwt.create_access_token - 🔗 DEPENDS_ON ->
backend.src.models.auth.User - 🔗 DEPENDS_ON ->
backend.src.models.auth.Role - ℂ AuthService (
Class)- 📝 Provides high-level authentication services.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the authentication service with repository access over an active DB session.
- ƒ authenticate_user (
Function)- 📝 Validates credentials and account state for local username/password authentication.
- ƒ create_session (
Function)- 📝 Issues an access token payload for an already authenticated user.
- ƒ provision_adfs_user (
Function)- 📝 Performs ADFS Just-In-Time provisioning and role synchronization from AD group mappings.
- 📦 backend.src.services.git_service (
Module)- 📝 Core Git logic using GitPython to manage dashboard repositories.
- 🏗️ Layer: Service
- 🔒 Invariant: All Git operations must be performed on a valid local directory.
- 🔗 DEPENDS_ON ->
backend.src.core.database.SessionLocal - 🔗 DEPENDS_ON ->
backend.src.models.config.AppConfigRecord - 🔗 DEPENDS_ON ->
backend.src.models.git.GitRepository - ℂ backend.src.services.git_service.GitService (
Class)- 📝 Wrapper for GitPython operations with semantic logging and error handling.
- ƒ backend.src.services.git_service.GitService.init (
Function)[TRIVIAL]- 📝 Initializes the GitService with a base path for repositories.
- ƒ _ensure_base_path_exists (
Function)[TRIVIAL]- 📝 Ensure the repositories root directory exists and is a directory.
- ƒ backend.src.services.git_service.GitService._resolve_base_path (
Function)[TRIVIAL]- 📝 Resolve base repository directory from explicit argument or global storage settings.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _resolve_base_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _get_repo_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_repo (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _read_blob_text (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _get_unmerged_file_paths (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _build_unfinished_merge_payload (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_merge_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_merge_conflicts (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolve_merge_conflicts (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ abort_merge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ continue_merge (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _derive_server_url_from_remote (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ create_gitea_pull_request (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ create_github_pull_request (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ create_gitlab_merge_request (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.mapping_service (
Module)[TRIVIAL]- 📝 Orchestrates database fetching and fuzzy matching suggestions.
- 🏗️ Layer: Service
- 🔒 Invariant: Suggestions are based on database names.
- 🔗 DEPENDS_ON ->
backend.src.core.superset_client - 🔗 DEPENDS_ON ->
backend.src.core.utils.matching - ℂ MappingService (
Class)[TRIVIAL]- 📝 Service for handling database mapping logic.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the mapping service with a config manager.
- ƒ _get_client (
Function)[TRIVIAL]- 📝 Helper to get an initialized SupersetClient for an environment.
- ƒ get_suggestions (
Function)[TRIVIAL]- 📝 Fetches databases from both environments and returns fuzzy matching suggestions.
- 📦 test_encryption_manager (
Module)- 📝 Unit tests for EncryptionManager encrypt/decrypt functionality.
- 🏗️ Layer: Domain
- 🔒 Invariant: Encrypt+decrypt roundtrip always returns original plaintext.
- ℂ TestEncryptionManager (
Class)[TRIVIAL]- 📝 Validate EncryptionManager encrypt/decrypt roundtrip, uniqueness, and error handling.
- ƒ test_encrypt_decrypt_roundtrip (
Function)[TRIVIAL]- 📝 Encrypt then decrypt returns original plaintext.
- ƒ test_encrypt_produces_different_output (
Function)[TRIVIAL]- 📝 Same plaintext produces different ciphertext (Fernet uses random IV).
- ƒ test_different_inputs_yield_different_ciphertext (
Function)[TRIVIAL]- 📝 Different inputs produce different ciphertexts.
- ƒ test_decrypt_invalid_data_raises (
Function)[TRIVIAL]- 📝 Decrypting invalid data raises InvalidToken.
- ƒ test_encrypt_empty_string (
Function)[TRIVIAL]- 📝 Encrypting and decrypting an empty string works.
- ƒ test_missing_key_fails_fast (
Function)[TRIVIAL]- 📝 Missing ENCRYPTION_KEY must abort initialization instead of using a fallback secret.
- ƒ test_custom_key_roundtrip (
Function)[TRIVIAL]- 📝 Custom Fernet key produces valid roundtrip.
- ƒ _make_manager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ encrypt (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ decrypt (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ encrypt (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ decrypt (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_health_service (
Module)- 📝 Unit tests for HealthService aggregation logic.
- ƒ test_get_health_summary_aggregation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_health_summary_empty (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_health_summary_resolves_slug_and_title_from_superset (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_health_summary_reuses_dashboard_metadata_cache_across_service_instances (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_delete_validation_report_deletes_dashboard_scope_and_linked_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_delete_validation_report_returns_false_for_unknown_record (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_delete_validation_report_swallows_linked_task_cleanup_failure (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.tests.test_llm_plugin_persistence (
Module)- 📝 Regression test for ValidationRecord persistence fields populated from task context.
- ℂ _DummyLogger (
Class)[TRIVIAL]- 📝 Minimal logger shim for TaskContext-like objects used in tests.
- ℂ _FakeDBSession (
Class)[TRIVIAL]- 📝 Captures persisted records for assertion and mimics SQLAlchemy session methods used by plugin.
- ƒ test_dashboard_validation_plugin_persists_task_and_environment_ids (
Function)[TRIVIAL]- 📝 Ensure db ValidationRecord includes context.task_id and params.environment_id.
- ƒ with_source (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ info (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ debug (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ warning (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ error (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ add (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ commit (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ close (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_provider (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_decrypted_api_key (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ capture_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ analyze_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ dispatch_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_environment (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_config (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.tests.test_llm_prompt_templates (
Module)- 📝 Validate normalization and rendering behavior for configurable LLM prompt templates.
- 🏗️ Layer: Domain Tests
- 🔒 Invariant: All required prompt keys remain available after normalization.
- 🔗 DEPENDS_ON ->
backend.src.services.llm_prompt_templates - ƒ test_normalize_llm_settings_adds_default_prompts (
Function)- 📝 Ensure legacy/partial llm settings are expanded with all prompt defaults.
- ƒ test_normalize_llm_settings_keeps_custom_prompt_values (
Function)- 📝 Ensure user-customized prompt values are preserved during normalization.
- ƒ test_render_prompt_replaces_known_placeholders (
Function)- 📝 Ensure template placeholders are deterministically replaced.
- ƒ test_is_multimodal_model_detects_known_vision_models (
Function)- 📝 Ensure multimodal model detection recognizes common vision-capable model names.
- ƒ test_resolve_bound_provider_id_prefers_binding_then_default (
Function)- 📝 Verify provider binding resolution priority.
- ƒ test_normalize_llm_settings_keeps_assistant_planner_settings (
Function)- 📝 Ensure assistant planner provider/model fields are preserved and normalized.
- 📦 _test_encryption_key_fixture (
Global)[TRIVIAL]- 📝 Ensure encryption-dependent provider tests run with a valid Fernet key.
- 📦 test_llm_provider (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/services/tests/test_llm_provider.py
- 🏗️ Layer: Unknown
- ƒ test_encryption_cycle (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_empty_string_encryption (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_decrypt_invalid_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ mock_db (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ service (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_all_providers (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_provider (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_decrypted_api_key (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_decrypted_api_key_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_update_provider_ignores_masked_placeholder_api_key (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.tests.test_resource_service (
Module)- 📝 Unit tests for ResourceService
- 🏗️ Layer: Service
- 🔒 Invariant: Resource summaries preserve task linkage and status projection behavior.
- ƒ test_get_dashboards_with_status (
Function)[TRIVIAL]- 📝 Validate dashboard enrichment includes git/task status projections.
- ƒ test_get_datasets_with_status (
Function)[TRIVIAL] - ƒ test_get_activity_summary (
Function)[TRIVIAL] - ƒ test_get_git_status_for_dashboard_no_repo (
Function)[TRIVIAL] - ƒ test_get_last_task_for_resource (
Function)[TRIVIAL] - ƒ test_extract_resource_name_from_task (
Function)[TRIVIAL] - ƒ test_get_last_task_for_resource_empty_tasks (
Function)[TRIVIAL] - ƒ test_get_last_task_for_resource_no_match (
Function)[TRIVIAL] - ƒ test_get_dashboards_with_status_handles_mixed_naive_and_aware_task_datetimes (
Function)[TRIVIAL] - ƒ test_get_dashboards_with_status_prefers_latest_decisive_validation_status_over_newer_unknown (
Function)[TRIVIAL] - ƒ test_get_dashboards_with_status_falls_back_to_latest_unknown_without_decisive_history (
Function)[TRIVIAL] - ƒ test_get_last_task_for_resource_handles_mixed_naive_and_aware_created_at (
Function)[TRIVIAL]
- 📦 backend.src.services.tests.test_rbac_permission_catalog (
Module)- 📝 Verifies RBAC permission catalog discovery and idempotent synchronization behavior.
- 🏗️ Layer: Service Tests
- 🔒 Invariant: Synchronization adds only missing normalized permission pairs.
- ƒ test_discover_route_permissions_extracts_declared_pairs_and_ignores_tests (
Function)[TRIVIAL]- 📝 Ensures route-scanner extracts has_permission pairs from route files and skips tests.
- ƒ test_discover_declared_permissions_unions_route_and_plugin_permissions (
Function)[TRIVIAL]- 📝 Ensures full catalog includes route-level permissions plus dynamic plugin EXECUTE rights.
- ƒ test_sync_permission_catalog_inserts_only_missing_normalized_pairs (
Function)[TRIVIAL]- 📝 Ensures synchronization inserts only missing pairs and normalizes action/resource tokens.
- ƒ test_sync_permission_catalog_is_noop_when_all_permissions_exist (
Function)[TRIVIAL]- 📝 Ensures synchronization is idempotent when all declared pairs already exist.
- 📦 backend.src.services.notifications.providers (
Module)[CRITICAL]- 📝 Defines abstract base and concrete implementations for external notification delivery.
- 🏗️ Layer: Infra
- 🔒 Invariant: Sensitive credentials must be handled via encrypted config.
- ℂ NotificationProvider (
Class)[TRIVIAL]- 📝 Abstract base class for all notification providers.
- ℂ SMTPProvider (
Class)[TRIVIAL]- 📝 Delivers notifications via SMTP.
- ℂ TelegramProvider (
Class)[TRIVIAL]- 📝 Delivers notifications via Telegram Bot API.
- ℂ SlackProvider (
Class)[TRIVIAL]- 📝 Delivers notifications via Slack Webhooks or API.
- ƒ send (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ send (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ send (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ send (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.notifications.service (
Module)[CRITICAL]- 📝 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]- 📝 Routes validation reports to appropriate users and channels.
- ƒ 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)
- 📦 src.services.notifications (
Package)[TRIVIAL]- 📝 Notification service package root.
- 📦 backend.src.services.notifications.tests.test_notification_service (
Module)- 📝 Unit tests for NotificationService routing and dispatch logic.
- ƒ mock_db (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ mock_config_manager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ service (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_should_notify_fail_only (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_should_notify_warn_and_fail (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_resolve_targets_owner_routing (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_resolve_targets_custom_channels (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_dispatch_report_skips_if_no_notify (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_dispatch_report_calls_providers (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.compliance_orchestrator (
Module)[CRITICAL]- 📝 Execute mandatory clean compliance stages and produce final COMPLIANT/BLOCKED/FAILED outcome.
- 🏗️ Layer: Domain
- 🔒 Invariant: COMPLIANT is impossible when any mandatory stage fails.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.stages - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.report_builder - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - ℂ CleanComplianceOrchestrator (
Class)[TRIVIAL]- 📝 Coordinate clean-release compliance verification stages.
- ƒ CleanComplianceOrchestrator.init (
Function)[TRIVIAL]- 📝 Bind repository dependency used for orchestrator persistence and lookups.
- ƒ start_check_run (
Function)[TRIVIAL]- 📝 Initiate a new compliance run session.
- ƒ execute_stages (
Function)[TRIVIAL]- 📝 Execute or accept compliance stage outcomes and set intermediate/final check-run status fields.
- ƒ finalize_run (
Function)[TRIVIAL]- 📝 Finalize run status based on cumulative stage results.
- ƒ run_check_legacy (
Function)[TRIVIAL]- 📝 Legacy wrapper for compatibility with previous orchestrator call style.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.compliance_execution_service (
Module)[CRITICAL]- 📝 Create and execute compliance runs with trusted snapshots, deterministic stages, violations and immutable report persistence.
- 🏗️ Layer: Domain
- 🔒 Invariant: A run binds to exactly one candidate/manifest/policy/registry snapshot set.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.policy_resolution_service - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.stages - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.report_builder - ℂ ComplianceExecutionResult (
Class)[TRIVIAL]- 📝 Return envelope for compliance execution with run/report and persisted stage artifacts.
- ℂ ComplianceExecutionService (
Class)[TRIVIAL]- 📝 Execute clean-release compliance lifecycle over trusted snapshots and immutable evidence.
- ƒ _resolve_manifest (
Function)[TRIVIAL]- 📝 Resolve explicit manifest or fallback to latest candidate manifest.
- ƒ _persist_stage_run (
Function)[TRIVIAL]- 📝 Persist stage run if repository supports stage records.
- ƒ _persist_violations (
Function)[TRIVIAL]- 📝 Persist stage violations via repository adapters.
- ƒ execute_run (
Function)[TRIVIAL]- 📝 Execute compliance run stages and finalize immutable report on terminal success.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.manifest_builder (
Module)- 📝 Build deterministic distribution manifest from classified artifact input.
- 🏗️ Layer: Domain
- 🔒 Invariant: Equal semantic artifact sets produce identical deterministic hash values.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release - ƒ build_distribution_manifest (
Function)[TRIVIAL]- 📝 Build DistributionManifest with deterministic hash and validated counters.
- ƒ build_manifest (
Function)[TRIVIAL]- 📝 Legacy compatibility wrapper for old manifest builder import paths.
- ƒ _stable_hash_payload (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.policy_engine (
Module)[CRITICAL]- 📝 Evaluate artifact/source policies for enterprise clean profile with deterministic outcomes.
- 🏗️ Layer: Domain
- 🔒 Invariant: Enterprise-clean policy always treats non-registry sources as violations.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release.CleanProfilePolicy - 🔗 DEPENDS_ON ->
backend.src.models.clean_release.ResourceSourceRegistry - ℂ CleanPolicyEngine (
Class)[TRIVIAL] - ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ validate_policy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ classify_artifact (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ validate_resource_source (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ evaluate_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 clean_release_exceptions (
Module)- 📝 Domain exceptions for clean release compliance subsystem.
- 🏗️ Layer: Domain
- 📦 backend.src.services.clean_release.candidate_service (
Module)[CRITICAL]- 📝 Register release candidates with validated artifacts and advance lifecycle through legal transitions.
- 🏗️ Layer: Domain
- 🔒 Invariant: Candidate lifecycle transitions are delegated to domain guard logic.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - 🔗 DEPENDS_ON ->
backend.src.models.clean_release - ƒ _validate_artifacts (
Function)[TRIVIAL]- 📝 Validate raw artifact payload list for required fields and shape.
- ƒ register_candidate (
Function)[TRIVIAL]- 📝 Register a candidate and persist its artifacts with legal lifecycle transition.
- 📦 clean_release_enums (
Module)- 📝 Canonical enums for clean release lifecycle and compliance.
- 🏗️ Layer: Domain
- 📦 backend.src.services.clean_release.publication_service (
Module)[CRITICAL]- 📝 Enforce publication and revocation gates with append-only publication records.
- 🏗️ Layer: Domain
- 🔒 Invariant: Publication records are append-only snapshots; revoke mutates only publication status for targeted record.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.approval_service - 🔗 DEPENDS_ON ->
backend.src.models.clean_release - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.audit_service - ƒ _get_or_init_publications_store (
Function)[TRIVIAL]- 📝 Provide in-memory append-only publication storage.
- ƒ _latest_publication_for_candidate (
Function)[TRIVIAL]- 📝 Resolve latest publication record for candidate.
- ƒ _latest_approval_for_candidate (
Function)[TRIVIAL]- 📝 Resolve latest approval decision from repository decision store.
- ƒ publish_candidate (
Function)[TRIVIAL]- 📝 Create immutable publication record for approved candidate.
- ƒ revoke_publication (
Function)[TRIVIAL]- 📝 Revoke existing publication record without deleting history.
- 📦 backend.src.services.clean_release.artifact_catalog_loader (
Module)- 📝 Load bootstrap artifact catalogs for clean release real-mode flows.
- 🏗️ Layer: Domain
- 🔒 Invariant: Artifact catalog must produce deterministic CandidateArtifact entries with required identity and checksum fields.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release.CandidateArtifact - ƒ load_bootstrap_artifacts (
Function)[TRIVIAL]- 📝 Parse artifact catalog JSON into CandidateArtifact models for TUI/bootstrap flows.
- 📦 backend.src.services.clean_release.audit_service (
Module)- 📝 Provide lightweight audit hooks for clean release preparation/check/report lifecycle.
- 🏗️ Layer: Infra
- 🔒 Invariant: Audit hooks are append-only log actions.
- 🔗 DEPENDS_ON ->
backend.src.core.logger - ƒ _append_event (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ audit_preparation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ audit_check_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ audit_violation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ audit_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.source_isolation (
Module)- 📝 Validate that all resource endpoints belong to the approved internal source registry.
- 🏗️ Layer: Domain
- 🔒 Invariant: Any endpoint outside enabled registry entries is treated as external-source violation.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release.ResourceSourceRegistry - ƒ validate_internal_sources (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.report_builder (
Module)[CRITICAL]- 📝 Build and persist compliance reports with consistent counter invariants.
- 🏗️ Layer: Domain
- 🔒 Invariant: blocking_violations_count never exceeds violations_count.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ build_report_payload (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ persist_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.repository (
Module)- 📝 Provide repository adapter for clean release entities with deterministic access methods.
- 🏗️ Layer: Infra
- 🔒 Invariant: Repository operations are side-effect free outside explicit save/update calls.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release - ℂ CleanReleaseRepository (
Class)[TRIVIAL]- 📝 Data access object for clean release lifecycle.
- ƒ save_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_policy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_policy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_active_policy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_registry (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_registry (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_artifact (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_artifacts_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_manifest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_manifest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_distribution_manifest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_distribution_manifest (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_check_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_check_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_compliance_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_compliance_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_violation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_violations_by_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_manifests_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ clear_history (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.preparation_service (
Module)- 📝 Prepare release candidate by policy evaluation and deterministic manifest creation.
- 🏗️ Layer: Domain
- 🔒 Invariant: Candidate preparation always persists manifest and candidate status deterministically.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.policy_engine - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.manifest_builder - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - ƒ prepare_candidate_legacy (
Function)[TRIVIAL]- 📝 Legacy compatibility wrapper kept for migration period.
- ƒ prepare_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 clean_release_facade (
Module)- 📝 Unified entry point for clean release operations.
- 🏗️ Layer: Application
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolve_active_policy_snapshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ resolve_active_registry_snapshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_candidate_overview (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_candidates (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.policy_resolution_service (
Module)[CRITICAL]- 📝 Resolve trusted policy and registry snapshots from ConfigManager without runtime overrides.
- 🏗️ Layer: Domain
- 🔒 Invariant: Trusted snapshot resolution is based only on ConfigManager active identifiers.
- 🔗 DEPENDS_ON ->
backend.src.core.config_manager - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.exceptions - ƒ resolve_trusted_policy_snapshots (
Function)[TRIVIAL]- 📝 Resolve immutable trusted policy and registry snapshots using active config IDs only.
- 📦 backend.src.services.clean_release.demo_data_service (
Module)- 📝 Provide deterministic namespace helpers and isolated in-memory repository creation for demo and real modes.
- 🏗️ Layer: Domain
- 🔒 Invariant: Demo and real namespaces must never collide for generated physical identifiers.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - ƒ resolve_namespace (
Function)[TRIVIAL]- 📝 Resolve canonical clean-release namespace for requested mode.
- ƒ build_namespaced_id (
Function)[TRIVIAL]- 📝 Build storage-safe physical identifier under mode namespace.
- ƒ create_isolated_repository (
Function)[TRIVIAL]- 📝 Create isolated in-memory repository instance for selected mode namespace.
- 📦 clean_release_dto (
Module)- 📝 Data Transfer Objects for clean release compliance subsystem.
- 🏗️ Layer: Application
- 📦 clean_release_mappers (
Module)- 📝 Map between domain entities (SQLAlchemy models) and DTOs.
- 🏗️ Layer: Application
- ƒ map_candidate_to_dto (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ map_manifest_to_dto (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ map_run_to_dto (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ map_report_to_dto (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 clean_release (
Module)- 📝 Redesigned clean release compliance subsystem.
- 🏗️ Layer: Domain
- 📦 backend.src.services.clean_release.manifest_service (
Module)[CRITICAL]- 📝 Build immutable distribution manifests with deterministic digest and version increment.
- 🏗️ Layer: Domain
- 🔒 Invariant: Existing manifests are never mutated.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.manifest_builder - 🔗 DEPENDS_ON ->
backend.src.models.clean_release - ƒ build_manifest_snapshot (
Function)[TRIVIAL]- 📝 Create a new immutable manifest version for a candidate.
- 📦 backend.src.services.clean_release.approval_service (
Module)[CRITICAL]- 📝 Enforce approval/rejection gates over immutable compliance reports.
- 🏗️ Layer: Domain
- 🔒 Invariant: Approval is allowed only for PASSED report bound to candidate; decisions are append-only.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - 🔗 DEPENDS_ON ->
backend.src.models.clean_release - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.audit_service - ƒ _get_or_init_decisions_store (
Function)[TRIVIAL]- 📝 Provide append-only in-memory storage for approval decisions.
- ƒ _latest_decision_for_candidate (
Function)[TRIVIAL]- 📝 Resolve latest approval decision for candidate from append-only store.
- ƒ _resolve_candidate_and_report (
Function)[TRIVIAL]- 📝 Validate candidate/report existence and ownership prior to decision persistence.
- ƒ approve_candidate (
Function)[TRIVIAL]- 📝 Persist immutable APPROVED decision and advance candidate lifecycle to APPROVED.
- ƒ reject_candidate (
Function)[TRIVIAL]- 📝 Persist immutable REJECTED decision without promoting candidate lifecycle.
- 📦 backend.tests.services.clean_release.test_audit_service (
Module)- 📝 Validate audit hooks emit expected log patterns for clean release lifecycle.
- 🏗️ Layer: Infra
- ƒ test_audit_preparation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_audit_check_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_audit_report (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_policy_engine (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/services/clean_release/tests/test_policy_engine.py
- 🏗️ Layer: Unknown
- ƒ enterprise_clean_setup (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_policy_valid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_missing_registry_ref (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_conflicting_registry (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_classify_artifact (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_validate_resource_source (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_evaluate_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.services.clean_release.test_compliance_orchestrator (
Module)- 📝 Validate compliance orchestrator stage transitions and final status derivation.
- 🏗️ Layer: Domain
- 🔒 Invariant: Failed mandatory stage forces BLOCKED terminal status.
- ƒ test_orchestrator_stage_failure_blocks_release (
Function)[TRIVIAL]- 📝 Verify mandatory stage failure forces BLOCKED final status.
- ƒ test_orchestrator_compliant_candidate (
Function)[TRIVIAL]- 📝 Verify happy path where all mandatory stages pass yields COMPLIANT.
- ƒ test_orchestrator_missing_stage_result (
Function)[TRIVIAL]- 📝 Verify incomplete mandatory stage set cannot end as COMPLIANT and results in FAILED.
- ƒ test_orchestrator_report_generation_error (
Function)[TRIVIAL]- 📝 Verify downstream report errors do not mutate orchestrator final status.
- 📦 backend.tests.services.clean_release.test_report_builder (
Module)- 📝 Validate compliance report builder counter integrity and blocked-run constraints.
- 🏗️ Layer: Domain
- 🔒 Invariant: blocked run requires at least one blocking violation.
- ƒ _terminal_run (
Function)[TRIVIAL]- 📝 Build terminal/non-terminal run fixtures for report builder tests.
- ƒ _blocking_violation (
Function)[TRIVIAL]- 📝 Build a blocking violation fixture for blocked report scenarios.
- ƒ test_report_builder_blocked_requires_blocking_violations (
Function)[TRIVIAL]- 📝 Verify BLOCKED run requires at least one blocking violation.
- ƒ test_report_builder_blocked_with_two_violations (
Function)[TRIVIAL]- 📝 Verify report builder generates conformant payload for a BLOCKED run with violations.
- ƒ test_report_builder_counter_consistency (
Function)[TRIVIAL]- 📝 Verify violations counters remain consistent for blocking payload.
- ƒ test_missing_operator_summary (
Function)[TRIVIAL]- 📝 Validate non-terminal run prevents operator summary/report generation.
- 📦 backend.tests.services.clean_release.test_manifest_builder (
Module)- 📝 Validate deterministic manifest generation behavior for US1.
- 🏗️ Layer: Domain
- 🔒 Invariant: Same input artifacts produce identical deterministic hash.
- ƒ test_manifest_deterministic_hash_for_same_input (
Function)[TRIVIAL]- 📝 Ensure hash is stable for same candidate/policy/artifact input.
- 📦 backend.tests.services.clean_release.test_stages (
Module)- 📝 Validate final status derivation logic from stage results.
- 🏗️ Layer: Domain
- ƒ test_derive_final_status_compliant (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_derive_final_status_blocked (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_derive_final_status_failed_missing (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_derive_final_status_failed_skipped (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.services.clean_release.test_source_isolation (
Module)- 📝 Verify internal source registry validation behavior.
- 🏗️ Layer: Domain
- 🔒 Invariant: External endpoints always produce blocking violations.
- ƒ _registry (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_validate_internal_sources_all_internal_ok (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_validate_internal_sources_external_blocked (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.services.clean_release.test_preparation_service (
Module)- 📝 Validate release candidate preparation flow, including policy evaluation and manifest persisting.
- 🏗️ Layer: Domain
- 🔒 Invariant: Candidate preparation always persists manifest and candidate status deterministically.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.preparation_service:Module - ƒ backend.tests.services.clean_release.test_preparation_service._mock_policy (
Function)[TRIVIAL]- 📝 Build a valid clean profile policy fixture for preparation tests.
- ƒ backend.tests.services.clean_release.test_preparation_service._mock_registry (
Function)[TRIVIAL]- 📝 Build an internal-only source registry fixture for preparation tests.
- ƒ backend.tests.services.clean_release.test_preparation_service._mock_candidate (
Function)[TRIVIAL]- 📝 Build a draft release candidate fixture with provided identifier.
- ƒ backend.tests.services.clean_release.test_preparation_service.test_prepare_candidate_success (
Function)[TRIVIAL]- 📝 Verify candidate transitions to PREPARED when evaluation returns no violations.
- ƒ backend.tests.services.clean_release.test_preparation_service.test_prepare_candidate_with_violations (
Function)[TRIVIAL]- 📝 Verify candidate transitions to BLOCKED when evaluation returns blocking violations.
- ƒ backend.tests.services.clean_release.test_preparation_service.test_prepare_candidate_not_found (
Function)[TRIVIAL]- 📝 Verify preparation raises ValueError when candidate does not exist.
- ƒ backend.tests.services.clean_release.test_preparation_service.test_prepare_candidate_no_active_policy (
Function)[TRIVIAL]- 📝 Verify preparation raises ValueError when no active policy is available.
- ƒ _mock_policy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _mock_registry (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _mock_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_prepare_candidate_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_prepare_candidate_with_violations (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_prepare_candidate_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_prepare_candidate_no_active_policy (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.stages.no_external_endpoints (
Module)- 📝 Block manifest payloads that expose external endpoints outside trusted schemes and hosts.
- 🏗️ Layer: Domain
- 🔒 Invariant: Endpoint outside allowed scheme/host always yields BLOCKED stage decision.
- 🔗 IMPLEMENTS ->
backend.src.services.clean_release.stages.base.ComplianceStage - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.stages.base - ℂ NoExternalEndpointsStage (
Class)[TRIVIAL]- 📝 Validate endpoint references from manifest against trusted registry.
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.stages.internal_sources_only (
Module)- 📝 Verify manifest-declared sources belong to trusted internal registry allowlist.
- 🏗️ Layer: Domain
- 🔒 Invariant: Any source host outside allowed_hosts yields BLOCKED decision with at least one violation.
- 🔗 IMPLEMENTS ->
backend.src.services.clean_release.stages.base.ComplianceStage - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.stages.base - ℂ InternalSourcesOnlyStage (
Class)[TRIVIAL]- 📝 Enforce internal-source-only policy from trusted registry snapshot.
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.stages.data_purity (
Module)- 📝 Evaluate manifest purity counters and emit blocking violations for prohibited artifacts.
- 🏗️ Layer: Domain
- 🔒 Invariant: prohibited_detected_count > 0 always yields BLOCKED stage decision.
- 🔗 IMPLEMENTS ->
backend.src.services.clean_release.stages.base.ComplianceStage - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.stages.base - ℂ DataPurityStage (
Class)[TRIVIAL]- 📝 Validate manifest summary for prohibited artifacts.
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.stages.base (
Module)- 📝 Define shared contracts and helpers for pluggable clean-release compliance stages.
- 🏗️ Layer: Domain
- 🔒 Invariant: Stage execution is deterministic for equal input context.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release - ℂ ComplianceStageContext (
Class)[TRIVIAL]- 📝 Immutable input envelope passed to each compliance stage.
- ℂ StageExecutionResult (
Class)[TRIVIAL]- 📝 Structured stage output containing decision, details and violations.
- ℂ ComplianceStage (
Class)[TRIVIAL]- 📝 Protocol for pluggable stage implementations.
- ƒ build_stage_run_record (
Function)[TRIVIAL]- 📝 Build persisted stage run record from stage result.
- ƒ build_violation (
Function)[TRIVIAL]- 📝 Construct a compliance violation with normalized defaults.
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.stages.manifest_consistency (
Module)- 📝 Ensure run is bound to the exact manifest snapshot and digest used at run creation time.
- 🏗️ Layer: Domain
- 🔒 Invariant: Digest mismatch between run and manifest yields ERROR with blocking violation evidence.
- 🔗 IMPLEMENTS ->
backend.src.services.clean_release.stages.base.ComplianceStage - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.stages.base - ℂ ManifestConsistencyStage (
Class)[TRIVIAL]- 📝 Validate run/manifest linkage consistency.
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.services.clean_release.stages (
Module)- 📝 Define compliance stage order and helper functions for deterministic run-state evaluation.
- 🏗️ Layer: Domain
- 🔒 Invariant: Stage order remains deterministic for all compliance runs.
- 🔗 DEPENDS_ON ->
backend.src.models.clean_release - ƒ build_default_stages (
Function)[TRIVIAL]- 📝 Build default deterministic stage pipeline implementation order.
- ƒ stage_result_map (
Function)[TRIVIAL]- 📝 Convert stage result list to dictionary by stage name.
- ƒ missing_mandatory_stages (
Function)[TRIVIAL]- 📝 Identify mandatory stages that are absent from run results.
- ƒ derive_final_status (
Function)[TRIVIAL]- 📝 Derive final run status from stage results with deterministic blocking behavior.
- 📦 candidate_repository (
Module)- 📝 Persist and query release candidates.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_by_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_all (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 compliance_repository (
Module)- 📝 Persist and query compliance runs, stage runs, and violations.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_runs_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_stage_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_stages_by_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_violation (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_violations (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_violations_by_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 audit_repository (
Module)- 📝 Persist and query audit logs for clean release operations.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ log (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 manifest_repository (
Module)- 📝 Persist and query distribution manifests.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_by_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_latest_for_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 artifact_repository (
Module)- 📝 Persist and query candidate artifacts.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_all (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_by_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 policy_repository (
Module)- 📝 Persist and query policy and registry snapshots.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_policy_snapshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_policy_snapshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save_registry_snapshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_registry_snapshot (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 report_repository (
Module)- 📝 Persist and query compliance reports.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_by_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_by_run (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 approval_repository (
Module)- 📝 Persist and query approval decisions.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_by_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_latest_for_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 publication_repository (
Module)- 📝 Persist and query publication records.
- 🏗️ Layer: Infra
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ save (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_by_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_latest_for_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ list_by_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 clean_release_repositories (
Module)- 📝 Export all clean release repositories.
- 📦 backend.src.services.reports.normalizer (
Module)[CRITICAL]- 📝 Convert task manager task objects into canonical unified TaskReport entities with deterministic fallback behavior.
- 🏗️ Layer: Domain
- 🔒 Invariant: Unknown task types and partial payloads remain visible via fallback mapping.
- 🔗 DEPENDS_ON ->
backend.src.core.task_manager.models.Task - 🔗 DEPENDS_ON ->
backend.src.models.report - 🔗 DEPENDS_ON ->
backend.src.services.reports.type_profiles - ƒ status_to_report_status (
Function)[TRIVIAL]- 📝 Normalize internal task status to canonical report status.
- ƒ build_summary (
Function)[TRIVIAL]- 📝 Build deterministic user-facing summary from task payload and status.
- ƒ extract_error_context (
Function)[TRIVIAL]- 📝 Extract normalized error context and next actions for failed/partial reports.
- ƒ normalize_task_report (
Function)[TRIVIAL]- 📝 Convert one Task to canonical TaskReport envelope.
- 📦 backend.src.services.reports.type_profiles (
Module)[CRITICAL]- 📝 Deterministic mapping of plugin/task identifiers to canonical report task types and fallback profile metadata.
- 🏗️ Layer: Domain
- 🔒 Invariant: Unknown input always resolves to TaskType.UNKNOWN with a single fallback profile.
- 🔗 DEPENDS_ON ->
backend.src.models.report.TaskType - 📦 PLUGIN_TO_TASK_TYPE (
Data)[TRIVIAL]- 📝 Maps plugin identifiers to normalized report task types.
- 📦 TASK_TYPE_PROFILES (
Data)[TRIVIAL]- 📝 Profile metadata registry for each normalized task type.
- ƒ resolve_task_type (
Function)[TRIVIAL]- 📝 Resolve canonical task type from plugin/task identifier with guaranteed fallback.
- ƒ get_type_profile (
Function)[TRIVIAL]- 📝 Return deterministic profile metadata for a task type.
- 📦 backend.src.services.reports.report_service (
Module)[CRITICAL]- 📝 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 - 🔗 DEPENDS_ON ->
backend.src.models.report - 🔗 DEPENDS_ON ->
backend.src.services.reports.normalizer - ℂ ReportsService (
Class)[CRITICAL]- 📝 Service layer for list/detail report retrieval and normalization.
- 🔒 Invariant: Service methods are read-only over task history source.
- ƒ init (
Function)[CRITICAL]- 📝 Initialize service with TaskManager dependency.
- 🔒 Invariant: Constructor performs no task mutations.
- ƒ _load_normalized_reports (
Function)[TRIVIAL]- 📝 Build normalized reports from all available tasks.
- 🔒 Invariant: Every returned item is a TaskReport.
- ƒ _to_utc_datetime (
Function)[TRIVIAL]- 📝 Normalize naive/aware datetime values to UTC-aware datetime for safe comparisons.
- 🔒 Invariant: Naive datetimes are interpreted as UTC to preserve deterministic ordering/filtering.
- ƒ _datetime_sort_key (
Function)[TRIVIAL]- 📝 Produce stable numeric sort key for report timestamps.
- 🔒 Invariant: Mixed naive/aware datetimes never raise TypeError.
- ƒ _matches_query (
Function)[TRIVIAL]- 📝 Apply query filtering to a report.
- 🔒 Invariant: Filter evaluation is side-effect free.
- ƒ _sort_reports (
Function)[TRIVIAL]- 📝 Sort reports deterministically according to query settings.
- 🔒 Invariant: Sorting criteria are deterministic for equal input.
- ƒ list_reports (
Function)[TRIVIAL]- 📝 Return filtered, sorted, paginated report collection.
- ƒ get_report_detail (
Function)[TRIVIAL]- 📝 Return one normalized report with timeline/diagnostics/next actions.
- 📦 src.services.reports (
Package)[TRIVIAL]- 📝 Report service package root.
- 📦 test_type_profiles (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/services/reports/tests/test_type_profiles.py
- 🏗️ Layer: Unknown
- ƒ test_resolve_task_type_fallbacks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_resolve_task_type_valid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_type_profile_valid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_type_profile_fallback (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_report_service (
Module)- 📝 Unit tests for ReportsService list/detail operations
- 🏗️ Layer: Domain
- ƒ _make_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_service (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_empty_tasks_returns_empty_collection (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_single_task_normalized (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_pagination_first_page (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_pagination_last_page (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_filter_by_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_filter_by_task_type (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_search_filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_sort_by_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_applied_filters_echoed (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_service (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_detail_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_detail_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_detail_includes_timeline (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_detail_failed_task_has_next_actions (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_detail_success_task_no_error_next_actions (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.test_report_normalizer (
Module)- 📝 Validate unknown task type fallback and partial payload normalization behavior.
- 🏗️ Layer: Domain (Tests)
- 🔒 Invariant: Unknown plugin types are mapped to canonical unknown task type.
- ƒ test_unknown_type_maps_to_unknown_profile (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_partial_payload_keeps_report_visible_with_placeholders (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_clean_release_plugin_maps_to_clean_release_task_type (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 BackupPlugin (
Module)[TRIVIAL]- 📝 A plugin that provides functionality to back up Superset dashboards.
- 🏗️ Layer: App
- 🔗 IMPLEMENTS ->
PluginBase - 🔗 DEPENDS_ON ->
superset_tool.client - 🔗 DEPENDS_ON ->
superset_tool.utils - ℂ BackupPlugin (
Class)[TRIVIAL]- 📝 Implementation of the backup plugin logic.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the unique identifier for the backup plugin.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the human-readable name of the backup plugin.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns a description of the backup plugin.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the version of the backup plugin.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend route for the backup plugin.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Returns the JSON schema for backup plugin parameters.
- ƒ execute (
Function)[TRIVIAL]- 📝 Executes the dashboard backup logic with TaskContext support.
- 📦 DebugPluginModule (
Module)[TRIVIAL]- 📝 Implements a plugin for system diagnostics and debugging Superset API responses.
- 🏗️ Layer: Plugins
- ℂ DebugPlugin (
Class)[TRIVIAL]- 📝 Plugin for system diagnostics and debugging.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the unique identifier for the debug plugin.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the human-readable name of the debug plugin.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns a description of the debug plugin.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the version of the debug plugin.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend route for the debug plugin.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Returns the JSON schema for the debug plugin parameters.
- ƒ execute (
Function)[TRIVIAL]- 📝 Executes the debug logic with TaskContext support.
- ƒ _test_db_api (
Function)[TRIVIAL]- 📝 Tests database API connectivity for source and target environments.
- ƒ _get_dataset_structure (
Function)[TRIVIAL]- 📝 Retrieves the structure of a dataset.
- 📦 SearchPluginModule (
Module)[TRIVIAL]- 📝 Implements a plugin for searching text patterns across all datasets in a specific Superset environment.
- 🏗️ Layer: Plugins
- ℂ SearchPlugin (
Class)[TRIVIAL]- 📝 Plugin for searching text patterns in Superset datasets.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the unique identifier for the search plugin.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the human-readable name of the search plugin.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns a description of the search plugin.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the version of the search plugin.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend route for the search plugin.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Returns the JSON schema for the search plugin parameters.
- ƒ execute (
Function)[TRIVIAL]- 📝 Executes the dataset search logic with TaskContext support.
- ƒ _get_context (
Function)[TRIVIAL]- 📝 Extracts a small context around the match for display.
- 📦 MapperPluginModule (
Module)[TRIVIAL]- 📝 Implements a plugin for mapping dataset columns using external database connections or Excel files.
- 🏗️ Layer: Plugins
- ℂ MapperPlugin (
Class)[TRIVIAL]- 📝 Plugin for mapping dataset columns verbose names.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the unique identifier for the mapper plugin.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the human-readable name of the mapper plugin.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns a description of the mapper plugin.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the version of the mapper plugin.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend route for the mapper plugin.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Returns the JSON schema for the mapper plugin parameters.
- ƒ execute (
Function)[TRIVIAL]- 📝 Executes the dataset mapping logic with TaskContext support.
- 📦 backend.src.plugins.git_plugin (
Module)[TRIVIAL]- 📝 Предоставляет плагин для версионирования и развертывания дашбордов Superset.
- 🏗️ Layer: Plugin
- 🔒 Invariant: Все операции с Git должны выполняться через GitService.
- ℂ GitPlugin (
Class)[TRIVIAL]- 📝 Реализация плагина Git Integration для управления версиями дашбордов.
- ƒ init (
Function)[TRIVIAL]- 📝 Инициализирует плагин и его зависимости.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the plugin identifier.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the plugin name.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns the plugin description.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the plugin version.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend route for the git plugin.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Возвращает JSON-схему параметров для выполнения задач плагина.
- ƒ initialize (
Function)[TRIVIAL]- 📝 Выполняет начальную настройку плагина.
- ƒ execute (
Function)[TRIVIAL]- 📝 Основной метод выполнения задач плагина с поддержкой TaskContext.
- 🔗 CALLS ->
self._handle_sync - 🔗 CALLS ->
self._handle_deploy
- ƒ _handle_sync (
Function)[TRIVIAL]- 📝 Экспортирует дашборд из Superset и распаковывает в Git-репозиторий.
- 🔗 CALLS ->
src.services.git_service.GitService.get_repo - 🔗 CALLS ->
src.core.superset_client.SupersetClient.export_dashboard
- ƒ _handle_deploy (
Function)[TRIVIAL]- 📝 Упаковывает репозиторий в ZIP и импортирует в целевое окружение Superset.
- 🔗 CALLS ->
src.core.superset_client.SupersetClient.import_dashboard
- ƒ _get_env (
Function)[TRIVIAL]- 📝 Вспомогательный метод для получения конфигурации окружения.
- 📦 MigrationPlugin (
Module)[CRITICAL]- 📝 Orchestrates export, DB-mapping transformation, and import of Superset dashboards across environments.
- 🏗️ Layer: App
- 🔒 Invariant: Dashboards must never be imported with unmapped/source DB connections to prevent data leaks or cross-environment pollution.
- 🔗 IMPLEMENTS ->
PluginBase - 🔗 DEPENDS_ON ->
SupersetClient - 🔗 DEPENDS_ON ->
MigrationEngine - 🔗 DEPENDS_ON ->
IdMappingService - ℂ MigrationPlugin (
Class)[CRITICAL]- 📝 Implementation of the migration plugin workflow and transformation orchestration.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the unique identifier for the migration plugin.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the human-readable name of the plugin.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns the semantic description of the plugin.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the semantic version of the migration plugin.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend routing anchor for the plugin.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Generates the JSON Schema for the plugin execution form dynamically.
- ƒ execute (
Function)[TRIVIAL]- 📝 Orchestrates the dashboard migration pipeline including extraction, AST mutation, and ingestion.
- 📦 src.plugins (
Package)[TRIVIAL]- 📝 Plugin package root for dynamic discovery and runtime imports.
- ƒ schedule_dashboard_validation (
Function)[TRIVIAL]- 📝 Schedules a recurring dashboard validation task.
- ƒ _parse_cron (
Function)[TRIVIAL]- 📝 Basic cron parser placeholder.
- 📦 scheduler (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/plugins/llm_analysis/scheduler.py
- 🏗️ Layer: Unknown
- ƒ job_func (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ℂ LLMProviderType (
Class)[TRIVIAL]- 📝 Enum for supported LLM providers.
- ℂ LLMProviderConfig (
Class)[TRIVIAL]- 📝 Configuration for an LLM provider.
- ℂ ValidationStatus (
Class)[TRIVIAL]- 📝 Enum for dashboard validation status.
- ℂ DetectedIssue (
Class)[TRIVIAL]- 📝 Model for a single issue detected during validation.
- ℂ ValidationResult (
Class)[TRIVIAL]- 📝 Model for dashboard validation result.
- ƒ _is_masked_or_invalid_api_key (
Function)[TRIVIAL]- 📝 Guards against placeholder or malformed API keys in runtime.
- ƒ _json_safe_value (
Function)[TRIVIAL]- 📝 Recursively normalize payload values for JSON serialization.
- ℂ DashboardValidationPlugin (
Class)[TRIVIAL]- 📝 Plugin for automated dashboard health analysis using LLMs.
- 🔗 IMPLEMENTS ->
backend.src.core.plugin_base.PluginBase - ƒ DashboardValidationPlugin.execute (
Function)[TRIVIAL]- 📝 Executes the dashboard validation task with TaskContext support.
- ℂ DocumentationPlugin (
Class)[TRIVIAL]- 📝 Plugin for automated dataset documentation using LLMs.
- 🔗 IMPLEMENTS ->
backend.src.core.plugin_base.PluginBase - ƒ DocumentationPlugin.execute (
Function)[TRIVIAL]- 📝 Executes the dataset documentation task with TaskContext support.
- 📦 plugin (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/plugins/llm_analysis/plugin.py
- 🏗️ Layer: Unknown
- ƒ id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ name (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ description (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ version (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ name (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ description (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ version (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ℂ ScreenshotService (
Class)[TRIVIAL]- 📝 Handles capturing screenshots of Superset dashboards.
- ƒ ScreenshotService.init (
Function)[TRIVIAL]- 📝 Initializes the ScreenshotService with environment configuration.
- ƒ ScreenshotService._find_first_visible_locator (
Function)[TRIVIAL]- 📝 Resolve the first visible locator from multiple Playwright locator strategies.
- ƒ ScreenshotService._iter_login_roots (
Function)[TRIVIAL]- 📝 Enumerate page and child frames where login controls may be rendered.
- ƒ ScreenshotService._extract_hidden_login_fields (
Function)[TRIVIAL]- 📝 Collect hidden form fields required for direct login POST fallback.
- ƒ ScreenshotService._extract_csrf_token (
Function)[TRIVIAL]- 📝 Resolve CSRF token value from main page or embedded login frame.
- ƒ ScreenshotService._response_looks_like_login_page (
Function)[TRIVIAL]- 📝 Detect when fallback login POST returned the login form again instead of an authenticated page.
- ƒ ScreenshotService._redirect_looks_authenticated (
Function)[TRIVIAL]- 📝 Treat non-login redirects after form POST as successful authentication without waiting for redirect target.
- ƒ ScreenshotService._submit_login_via_form_post (
Function)[TRIVIAL]- 📝 Fallback login path that submits credentials directly with csrf token.
- ƒ ScreenshotService._find_login_field_locator (
Function)[TRIVIAL]- 📝 Resolve login form input using semantic label text plus generic visible-input fallbacks.
- ƒ ScreenshotService._find_submit_locator (
Function)[TRIVIAL]- 📝 Resolve login submit button from main page or embedded auth frame.
- ƒ ScreenshotService._goto_resilient (
Function)[TRIVIAL]- 📝 Navigate without relying on networkidle for pages with long-polling or persistent requests.
- ƒ ScreenshotService.capture_dashboard (
Function)[TRIVIAL]- 📝 Captures a full-page screenshot of a dashboard using Playwright and CDP.
- ℂ LLMClient (
Class)[TRIVIAL]- 📝 Wrapper for LLM provider APIs.
- ƒ LLMClient.init (
Function)[TRIVIAL]- 📝 Initializes the LLMClient with provider settings.
- ƒ LLMClient._supports_json_response_format (
Function)[TRIVIAL]- 📝 Detect whether provider/model is likely compatible with response_format=json_object.
- ƒ LLMClient.get_json_completion (
Function)[TRIVIAL]- 📝 Helper to handle LLM calls with JSON mode and fallback parsing.
- ƒ LLMClient.test_runtime_connection (
Function)[TRIVIAL]- 📝 Validate provider credentials using the same chat completions transport as runtime analysis.
- ƒ LLMClient.analyze_dashboard (
Function)[TRIVIAL]- 📝 Sends dashboard data (screenshot + logs) to LLM for health analysis.
- 📦 service (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/plugins/llm_analysis/service.py
- 🏗️ Layer: Unknown
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _find_first_visible_locator (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _iter_login_roots (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _extract_hidden_login_fields (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _extract_csrf_token (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _response_looks_like_login_page (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _redirect_looks_authenticated (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _submit_login_via_form_post (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _find_login_field_locator (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _find_submit_locator (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _goto_resilient (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ capture_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ switch_tabs (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _supports_json_response_format (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _should_retry (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_json_completion (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_runtime_connection (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ analyze_dashboard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.plugins.llm_analysis.tests.test_service (
Module)- 📝 Verify LLM analysis transport/provider failures do not masquerade as dashboard FAIL results.
- ƒ test_test_runtime_connection_uses_json_completion_transport (
Function)[TRIVIAL]- 📝 Provider self-test must exercise the same chat completion transport as runtime analysis.
- ƒ test_analyze_dashboard_provider_error_maps_to_unknown (
Function)[TRIVIAL]- 📝 Infrastructure/provider failures must produce UNKNOWN analysis status rather than FAIL.
- ƒ _fake_get_json_completion (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _raise_provider_error (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.src.plugins.llm_analysis.tests.test_client_headers (
Module)- 📝 Verify OpenRouter client initialization includes provider-specific headers.
- ƒ test_openrouter_client_includes_referer_and_title_headers (
Function)[TRIVIAL]- 📝 OpenRouter requests should carry site/app attribution headers for compatibility.
- 📦 backend.src.plugins.llm_analysis.tests.test_screenshot_service (
Module)- 📝 Protect dashboard screenshot navigation from brittle networkidle waits.
- ƒ test_iter_login_roots_includes_child_frames (
Function)[TRIVIAL]- 📝 Login discovery must search embedded auth frames, not only the main page.
- ƒ test_response_looks_like_login_page_detects_login_markup (
Function)[TRIVIAL]- 📝 Direct login fallback must reject responses that render the login screen again.
- ƒ test_find_first_visible_locator_skips_hidden_first_match (
Function)[TRIVIAL]- 📝 Locator helper must not reject a selector collection just because its first element is hidden.
- ƒ test_submit_login_via_form_post_uses_browser_context_request (
Function)[TRIVIAL]- 📝 Fallback login must submit hidden fields and credentials through the context request cookie jar.
- ƒ test_submit_login_via_form_post_accepts_authenticated_redirect (
Function)[TRIVIAL]- 📝 Fallback login must treat non-login 302 redirect as success without waiting for redirect target.
- ƒ test_submit_login_via_form_post_rejects_login_markup_response (
Function)[TRIVIAL]- 📝 Fallback login must fail when POST response still contains login form content.
- ƒ test_goto_resilient_falls_back_from_domcontentloaded_to_load (
Function)[TRIVIAL]- 📝 Pages with unstable primary wait must retry with fallback wait strategy.
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ is_visible (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ count (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ nth (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_attribute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ input_value (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ count (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ nth (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ text (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ post (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ locator (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_attribute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ input_value (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ count (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ nth (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ text (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ post (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ locator (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_attribute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ input_value (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ count (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ nth (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ text (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ post (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ locator (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ goto (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 StoragePlugin (
Module)[TRIVIAL]- 📝 Provides core filesystem operations for managing backups and repositories.
- 🏗️ Layer: App
- 🔒 Invariant: All file operations must be restricted to the configured storage root.
- 🔗 IMPLEMENTS ->
PluginBase - 🔗 DEPENDS_ON ->
backend.src.models.storage - ℂ StoragePlugin (
Class)[TRIVIAL]- 📝 Implementation of the storage management plugin.
- ƒ init (
Function)[TRIVIAL]- 📝 Initializes the StoragePlugin and ensures required directories exist.
- ƒ id (
Function)[TRIVIAL]- 📝 Returns the unique identifier for the storage plugin.
- ƒ name (
Function)[TRIVIAL]- 📝 Returns the human-readable name of the storage plugin.
- ƒ description (
Function)[TRIVIAL]- 📝 Returns a description of the storage plugin.
- ƒ version (
Function)[TRIVIAL]- 📝 Returns the version of the storage plugin.
- ƒ ui_route (
Function)[TRIVIAL]- 📝 Returns the frontend route for the storage plugin.
- ƒ get_schema (
Function)[TRIVIAL]- 📝 Returns the JSON schema for storage plugin parameters.
- ƒ execute (
Function)[TRIVIAL]- 📝 Executes storage-related tasks with TaskContext support.
- ƒ get_storage_root (
Function)[TRIVIAL]- 📝 Resolves the absolute path to the storage root.
- ƒ resolve_path (
Function)[TRIVIAL]- 📝 Resolves a dynamic path pattern using provided variables.
- ƒ ensure_directories (
Function)[TRIVIAL]- 📝 Creates the storage root and category subdirectories if they don't exist.
- ƒ validate_path (
Function)[TRIVIAL]- 📝 Prevents path traversal attacks by ensuring the path is within the storage root.
- ƒ list_files (
Function)[TRIVIAL]- 📝 Lists all files and directories in a specific category and subpath.
- ƒ save_file (
Function)[TRIVIAL]- 📝 Saves an uploaded file to the specified category and optional subpath.
- ƒ delete_file (
Function)[TRIVIAL]- 📝 Deletes a file or directory from the specified category and path.
- ƒ get_file_path (
Function)[TRIVIAL]- 📝 Returns the absolute path of a file for download.
- ℂ GitLLMExtension (
Class)[TRIVIAL]- 📝 Provides LLM capabilities to the Git plugin.
- ƒ suggest_commit_message (
Function)[TRIVIAL]- 📝 Generates a suggested commit message based on a diff and history.
- 📦 llm_extension (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/src/plugins/git/llm_extension.py
- 🏗️ Layer: Unknown
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 src.plugins.git (
Package)[TRIVIAL]- 📝 Git plugin extension package root.
- 📦 test_task_persistence (
Module)- 📝 Unit tests for TaskPersistenceService.
- 🏗️ Layer: Test
- ℂ TestTaskPersistenceHelpers (
Class)- 📝 Test suite for TaskPersistenceService static helper methods.
- ƒ test_json_load_if_needed_none (
Function)[TRIVIAL]- 📝 Test _json_load_if_needed with None input.
- ƒ test_json_load_if_needed_dict (
Function)[TRIVIAL]- 📝 Test _json_load_if_needed with dict input.
- ƒ test_json_load_if_needed_list (
Function)[TRIVIAL]- 📝 Test _json_load_if_needed with list input.
- ƒ test_json_load_if_needed_json_string (
Function)[TRIVIAL]- 📝 Test _json_load_if_needed with JSON string.
- ƒ test_json_load_if_needed_empty_string (
Function)[TRIVIAL]- 📝 Test _json_load_if_needed with empty/null strings.
- ƒ test_json_load_if_needed_plain_string (
Function)[TRIVIAL]- 📝 Test _json_load_if_needed with non-JSON string.
- ƒ test_json_load_if_needed_integer (
Function)[TRIVIAL]- 📝 Test _json_load_if_needed with integer.
- ƒ test_parse_datetime_none (
Function)[TRIVIAL]- 📝 Test _parse_datetime with None.
- ƒ test_parse_datetime_datetime_object (
Function)[TRIVIAL]- 📝 Test _parse_datetime with datetime object.
- ƒ test_parse_datetime_iso_string (
Function)[TRIVIAL]- 📝 Test _parse_datetime with ISO string.
- ƒ test_parse_datetime_invalid_string (
Function)[TRIVIAL]- 📝 Test _parse_datetime with invalid string.
- ƒ test_parse_datetime_integer (
Function)[TRIVIAL]- 📝 Test _parse_datetime with non-string, non-datetime.
- ℂ TestTaskPersistenceService (
Class)- 📝 Test suite for TaskPersistenceService CRUD operations.
- ƒ setup_class (
Function)[TRIVIAL]- 📝 Setup in-memory test database.
- ƒ teardown_class (
Function)[TRIVIAL]- 📝 Dispose of test database.
- ƒ setup_method (
Function)[TRIVIAL]- 📝 Clean task_records table before each test.
- ƒ test_persist_task_new (
Function)[TRIVIAL]- 📝 Test persisting a new task creates a record.
- ƒ test_persist_task_update (
Function)[TRIVIAL]- 📝 Test updating an existing task.
- ƒ test_persist_task_with_logs (
Function)[TRIVIAL]- 📝 Test persisting a task with log entries.
- ƒ test_persist_task_failed_extracts_error (
Function)[TRIVIAL]- 📝 Test that FAILED task extracts last error message.
- ƒ test_persist_tasks_batch (
Function)[TRIVIAL]- 📝 Test persisting multiple tasks.
- ƒ test_load_tasks (
Function)[TRIVIAL]- 📝 Test loading tasks from database.
- ƒ test_load_tasks_with_status_filter (
Function)[TRIVIAL]- 📝 Test loading tasks filtered by status.
- ƒ test_load_tasks_with_limit (
Function)[TRIVIAL]- 📝 Test loading tasks with limit.
- ƒ test_delete_tasks (
Function)[TRIVIAL]- 📝 Test deleting tasks by ID list.
- ƒ test_delete_tasks_empty_list (
Function)[TRIVIAL]- 📝 Test deleting with empty list (no-op).
- ƒ test_persist_task_with_datetime_in_params (
Function)[TRIVIAL]- 📝 Test json_serializable handles datetime in params.
- ƒ test_persist_task_resolves_environment_slug_to_existing_id (
Function)[TRIVIAL]- 📝 Ensure slug-like environment token resolves to environments.id before persisting task.
- ƒ _patched (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_environment_model (
Function)[TRIVIAL]- 📝 Tests that Environment model correctly stores values.
- 📦 test_task_manager (
Module)- 📝 Unit tests for TaskManager lifecycle, CRUD, log buffering, and filtering.
- 🏗️ Layer: Core
- 🔒 Invariant: TaskManager state changes are deterministic and testable with mocked dependencies.
- ƒ _make_manager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _cleanup_manager (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_init_creates_empty_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_init_loads_persisted_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_init_starts_flusher_thread (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_task_returns_none_for_missing (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_task_returns_existing (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_all_tasks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_tasks_with_status_filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_tasks_with_plugin_filter (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_tasks_with_pagination (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_tasks_completed_only (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_task_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_task_unknown_plugin_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_task_invalid_params_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_add_log_appends_to_task_and_buffer (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_add_log_skips_nonexistent_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_flush_logs_writes_to_persistence (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_flush_task_logs_writes_single_task (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_flush_logs_requeues_on_failure (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_clear_all_non_active (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_clear_by_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_clear_preserves_awaiting_input (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_subscribe_creates_queue (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_unsubscribe_removes_queue (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_multiple_subscribers (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_await_input_sets_status (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_await_input_not_running_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_await_input_nonexistent_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_resume_with_password (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_resume_not_awaiting_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_resume_empty_passwords_raises (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.test_dashboards_api (
Module)- 📝 Comprehensive contract-driven tests for Dashboard Hub API
- 🏗️ Layer: Domain (Tests)
- ƒ mock_deps (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_with_search (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_empty (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_superset_failure (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_env_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_invalid_pagination (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_database_mappings_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_database_mappings_env_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboard_detail_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboard_detail_env_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboard_tasks_history_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboard_tasks_history_sorting (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboard_thumbnail_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboard_thumbnail_env_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboard_thumbnail_202 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_migrate_dashboards_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_migrate_dashboards_pre_checks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_migrate_dashboards_env_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_backup_dashboards_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_backup_dashboards_pre_checks (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_backup_dashboards_env_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_backup_dashboards_with_schedule (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_task_matches_dashboard_logic (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_dashboards_api (
Test)[TRIVIAL]- 📝 Verify GET /api/dashboards contract compliance
- 📦 test_datasets_api (
Test)[TRIVIAL]- 📝 Verify GET /api/datasets contract compliance
- 📦 test_pagination_boundaries (
Test)[TRIVIAL]- 📝 Verify pagination validation for GET endpoints
- 📦 test_resource_hubs (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/tests/test_resource_hubs.py
- 🏗️ Layer: Unknown
- ƒ mock_deps (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_search (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_datasets_success (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_datasets_not_found (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_datasets_search (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_datasets_service_failure (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_pagination_zero_page (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_dashboards_pagination_oversize (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_datasets_pagination_zero_page (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_datasets_pagination_oversize (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_task_logger (
Module)- 📝 Unit tests for TaskLogger and TaskContext.
- 🏗️ Layer: Test
- ℂ TestTaskLogger (
Class)- 📝 Test suite for TaskLogger.
- ƒ setup_method (
Function)[TRIVIAL]- 📝 Setup for each test method.
- ƒ test_init (
Function)[TRIVIAL]- 📝 Test TaskLogger initialization.
- ƒ test_with_source (
Function)[TRIVIAL]- 📝 Test creating a sub-logger with different source.
- ƒ test_debug (
Function)[TRIVIAL]- 📝 Test debug log level.
- ƒ test_info (
Function)[TRIVIAL]- 📝 Test info log level.
- ƒ test_warning (
Function)[TRIVIAL]- 📝 Test warning log level.
- ƒ test_error (
Function)[TRIVIAL]- 📝 Test error log level.
- ƒ test_error_with_metadata (
Function)[TRIVIAL]- 📝 Test error logging with metadata.
- ƒ test_progress (
Function)[TRIVIAL]- 📝 Test progress logging.
- ƒ test_progress_clamping (
Function)[TRIVIAL]- 📝 Test progress value clamping (0-100).
- ƒ test_source_override (
Function)[TRIVIAL]- 📝 Test overriding the default source.
- ƒ test_sub_logger_source_independence (
Function)[TRIVIAL]- 📝 Test sub-logger independence from parent.
- ℂ TestTaskContext (
Class)- 📝 Test suite for TaskContext.
- ƒ setup_method (
Function)[TRIVIAL]- 📝 Setup for each test method.
- ƒ test_init (
Function)[TRIVIAL]- 📝 Test TaskContext initialization.
- ƒ test_task_id_property (
Function)[TRIVIAL]- 📝 Test task_id property.
- ƒ test_logger_property (
Function)[TRIVIAL]- 📝 Test logger property.
- ƒ test_params_property (
Function)[TRIVIAL]- 📝 Test params property.
- ƒ test_get_param (
Function)[TRIVIAL]- 📝 Test getting a specific parameter.
- ƒ test_create_sub_context (
Function)[TRIVIAL]- 📝 Test creating a sub-context with different source.
- ƒ test_context_logger_delegates_to_task_logger (
Function)[TRIVIAL]- 📝 Test context logger delegates to TaskLogger.
- ƒ test_sub_context_with_source (
Function)[TRIVIAL]- 📝 Test sub-context logger uses new source.
- ƒ test_multiple_sub_contexts (
Function)[TRIVIAL]- 📝 Test creating multiple sub-contexts.
- 📦 test_smoke_plugins (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/tests/test_smoke_plugins.py
- 🏗️ Layer: Unknown
- ƒ test_plugins_load_successfully (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_task_manager_initializes_with_plugins (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 tests.test_logger (
Module)- 📝 Unit tests for the custom logger formatters and configuration context manager.
- 🏗️ Layer: Logging (Tests)
- 🔒 Invariant: All required log statements must correctly check the threshold.
- ƒ test_belief_scope_logs_entry_action_exit_at_debug (
Function)[TRIVIAL]- 📝 Test that belief_scope generates [ID][Entry], [ID][Action], and [ID][Exit] logs at DEBUG level.
- ƒ test_belief_scope_error_handling (
Function)[TRIVIAL]- 📝 Test that belief_scope logs Coherence:Failed on exception.
- ƒ test_belief_scope_success_coherence (
Function)[TRIVIAL]- 📝 Test that belief_scope logs Coherence:OK on success.
- ƒ test_belief_scope_not_visible_at_info (
Function)[TRIVIAL]- 📝 Test that belief_scope Entry/Exit/Coherence logs are NOT visible at INFO level.
- ƒ test_task_log_level_default (
Function)[TRIVIAL]- 📝 Test that default task log level is INFO.
- ƒ test_should_log_task_level (
Function)[TRIVIAL]- 📝 Test that should_log_task_level correctly filters log levels.
- ƒ test_configure_logger_task_log_level (
Function)[TRIVIAL]- 📝 Test that configure_logger updates task_log_level.
- ƒ test_enable_belief_state_flag (
Function)[TRIVIAL]- 📝 Test that enable_belief_state flag controls belief_scope logging.
- 📦 test_auth (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/tests/test_auth.py
- 🏗️ Layer: Unknown
- ƒ db_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ auth_service (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ auth_repo (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_authenticate_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_role_permission_association (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_user_role_association (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_ad_group_mapping (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_admin_creates_user_with_optional_email (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_create_admin_is_idempotent_for_existing_user (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_ensure_encryption_key_generates_backend_env_file (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_ensure_encryption_key_reuses_existing_env_file_value (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_ensure_encryption_key_prefers_process_environment (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ verify_fernet_key (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_log_persistence (
Module)- 📝 Unit tests for TaskLogPersistenceService.
- 🏗️ Layer: Test
- ℂ TestLogPersistence (
Class)- 📝 Test suite for TaskLogPersistenceService.
- ƒ setup_class (
Function)[TRIVIAL]- 📝 Setup test database and service instance.
- ƒ teardown_class (
Function)[TRIVIAL]- 📝 Clean up test database.
- ƒ setup_method (
Function)[TRIVIAL]- 📝 Setup for each test method — clean task_logs table.
- ƒ test_add_logs_single (
Function)[TRIVIAL]- 📝 Test adding a single log entry.
- ƒ test_add_logs_batch (
Function)[TRIVIAL]- 📝 Test adding multiple log entries in batch.
- ƒ test_add_logs_empty (
Function)[TRIVIAL]- 📝 Test adding empty log list (should be no-op).
- ƒ test_get_logs_by_task_id (
Function)[TRIVIAL]- 📝 Test retrieving logs by task ID.
- ƒ test_get_logs_with_filters (
Function)[TRIVIAL]- 📝 Test retrieving logs with level and source filters.
- ƒ test_get_logs_with_pagination (
Function)[TRIVIAL]- 📝 Test retrieving logs with pagination.
- ƒ test_get_logs_with_search (
Function)[TRIVIAL]- 📝 Test retrieving logs with search query.
- ƒ test_get_log_stats (
Function)[TRIVIAL]- 📝 Test retrieving log statistics.
- ƒ test_get_sources (
Function)[TRIVIAL]- 📝 Test retrieving unique log sources.
- ƒ test_delete_logs_for_task (
Function)[TRIVIAL]- 📝 Test deleting logs by task ID.
- ƒ test_delete_logs_for_tasks (
Function)[TRIVIAL]- 📝 Test deleting logs for multiple tasks.
- ƒ test_delete_logs_for_tasks_empty (
Function)[TRIVIAL]- 📝 Test deleting with empty list (no-op).
- ƒ _patched (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_clean_release_cli (
Module)- 📝 Smoke tests for the redesigned clean release CLI.
- 🏗️ Layer: Domain
- ƒ test_cli_candidate_register_scaffold (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_cli_manifest_build_scaffold (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_cli_compliance_run_scaffold (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_cli_release_gate_commands_scaffold (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.scripts.test_clean_release_tui (
Module)- 📝 Unit tests for the interactive curses TUI of the clean release process.
- 🏗️ Layer: Scripts
- 🔒 Invariant: TUI initializes, handles hotkeys (F5, F10) and safely falls back without TTY.
- ƒ mock_stdscr (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_headless_fallback (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_initial_render (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_run_checks_f5 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ side_effect (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_exit_f10 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_clear_history_f7 (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_real_mode_bootstrap_imports_artifacts_catalog (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_clean_release_tui_v2 (
Module)- 📝 Smoke tests for thin-client TUI action dispatch and blocked transition behavior.
- 🏗️ Layer: Domain
- ƒ _build_mock_stdscr (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_f5_dispatches_run_action (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_f5_run_smoke_reports_blocked_state (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _set_blocked_state (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_non_tty_refuses_startup (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_tui_f8_blocked_without_facade_binding (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.core.test_git_service_gitea_pr (
Module)- 📝 Validate Gitea PR creation fallback behavior when configured server URL is stale.
- 🏗️ Layer: Domain
- 🔒 Invariant: A 404 from primary Gitea URL retries once against remote-url host when different.
- ƒ test_derive_server_url_from_remote_strips_credentials (
Function)[TRIVIAL]- 📝 Ensure helper returns host base URL and removes embedded credentials.
- ƒ test_create_gitea_pull_request_retries_with_remote_host_on_404 (
Function)[TRIVIAL]- 📝 Verify create_gitea_pull_request retries with remote URL host after primary 404.
- ƒ test_create_gitea_pull_request_returns_branch_error_when_target_missing (
Function)[TRIVIAL]- 📝 Ensure Gitea 404 on PR creation is mapped to actionable target-branch validation error.
- ƒ fake_gitea_request (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ fake_gitea_request (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.core.test_mapping_service (
Module)- 📝 Unit tests for the IdMappingService matching UUIDs to integer IDs.
- 🏗️ Layer: Domain
- ƒ db_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_all_resources (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_sync_environment_upserts_correctly (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_remote_id_returns_integer (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_remote_ids_batch_returns_dict (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_sync_environment_updates_existing_mapping (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_sync_environment_skips_resources_without_uuid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_sync_environment_handles_api_error_gracefully (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_all_resources (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_remote_id_returns_none_for_missing (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_get_remote_ids_batch_returns_empty_for_empty_input (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_mapping_service_alignment_with_test_data (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_sync_environment_requires_existing_env (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_sync_environment_deletes_stale_mappings (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 test_defensive_guards (
Module)[TRIVIAL]- 📝 Auto-generated module for backend/tests/core/test_defensive_guards.py
- 🏗️ Layer: Unknown
- ƒ test_git_service_get_repo_path_guard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_git_service_get_repo_path_recreates_base_dir (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_superset_client_import_dashboard_guard (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_git_service_init_repo_reclones_when_path_is_not_a_git_repo (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_git_service_ensure_gitflow_branches_creates_and_pushes_missing_defaults (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ fetch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ push (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ create_head (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ remote (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_git_service_configure_identity_updates_repo_local_config (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.core.test_migration_engine (
Module)- 📝 Unit tests for MigrationEngine's cross-filter patching algorithms.
- 🏗️ Layer: Domain
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_remote_ids_batch (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _write_dashboard_yaml (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_patch_dashboard_metadata_replaces_chart_ids (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_patch_dashboard_metadata_replaces_dataset_ids (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_patch_dashboard_metadata_skips_when_no_metadata (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_patch_dashboard_metadata_handles_missing_targets (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_extract_chart_uuids_from_archive (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_transform_yaml_replaces_database_uuid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_transform_yaml_ignores_unmapped_uuid (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_transform_zip_end_to_end (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_transform_zip_invalid_path (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_transform_yaml_nonexistent_file (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.core.migration.test_dry_run_orchestrator (
Module)- 📝 Unit tests for MigrationDryRunService diff and risk computation contracts.
- 🏗️ Layer: Domain
- ƒ _load_fixture (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _make_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_migration_dry_run_service_builds_diff_and_risk (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.core.migration.test_archive_parser (
Module)- 📝 Unit tests for MigrationArchiveParser ZIP extraction contract.
- 🏗️ Layer: Domain
- ƒ test_extract_objects_from_zip_collects_all_types (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.services.clean_release.test_publication_service (
Module)- 📝 Define publication gate contracts over approved candidates and immutable publication records.
- 🏗️ Layer: Tests
- 🔒 Invariant: Publish requires approval; revoke requires existing publication; republish after revoke is allowed as a new record.
- ƒ _seed_candidate_with_passed_report (
Function)[TRIVIAL]- 📝 Seed candidate/report fixtures for publication gate scenarios.
- ƒ test_publish_without_approval_rejected (
Function)[TRIVIAL]- 📝 Ensure publish action is blocked until candidate is approved.
- ƒ test_revoke_unknown_publication_rejected (
Function)[TRIVIAL]- 📝 Ensure revocation is rejected for unknown publication id.
- ƒ test_republish_after_revoke_creates_new_active_record (
Function)[TRIVIAL]- 📝 Ensure republish after revoke is allowed and creates a new ACTIVE record.
- 📦 backend.tests.services.clean_release.test_compliance_task_integration (
Module)- 📝 Verify clean release compliance runs execute through TaskManager lifecycle with observable success/failure outcomes.
- 🏗️ Layer: Tests
- 🔒 Invariant: Compliance execution triggered as task produces terminal task status and persists run evidence.
- ƒ _seed_repository (
Function)[TRIVIAL]- 📝 Prepare deterministic candidate/policy/registry/manifest fixtures for task integration tests.
- ℂ CleanReleaseCompliancePlugin (
Class)[TRIVIAL]- 📝 TaskManager plugin shim that executes clean release compliance orchestration.
- ℂ _PluginLoaderStub (
Class)[TRIVIAL]- 📝 Provide minimal plugin loader contract used by TaskManager in integration tests.
- ƒ _make_task_manager (
Function)[TRIVIAL]- 📝 Build TaskManager with mocked persistence services for isolated integration tests.
- ƒ _wait_for_terminal_task (
Function)[TRIVIAL]- 📝 Poll task registry until target task reaches terminal status.
- ƒ test_compliance_run_executes_as_task_manager_task (
Function)[TRIVIAL]- 📝 Verify successful compliance execution is observable as TaskManager SUCCESS task.
- ƒ test_compliance_run_missing_manifest_marks_task_failed (
Function)[TRIVIAL]- 📝 Verify missing manifest startup failure is surfaced as TaskManager FAILED task.
- ƒ id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ name (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ execute (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ init (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ has_plugin (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ get_plugin (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.services.clean_release.test_demo_mode_isolation (
Module)- 📝 Verify demo and real mode namespace isolation contracts before TUI integration.
- 🏗️ Layer: Tests
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.demo_data_service - ƒ test_resolve_namespace_separates_demo_and_real (
Function)[TRIVIAL]- 📝 Ensure namespace resolver returns deterministic and distinct namespaces.
- ƒ test_build_namespaced_id_prevents_cross_mode_collisions (
Function)[TRIVIAL]- 📝 Ensure ID generation prevents demo/real collisions for identical logical IDs.
- ƒ test_create_isolated_repository_keeps_mode_data_separate (
Function)[TRIVIAL]- 📝 Verify demo and real repositories do not leak state across mode boundaries.
- 📦 backend.tests.services.clean_release.test_report_audit_immutability (
Module)- 📝 Validate report snapshot immutability expectations and append-only audit hook behavior for US2.
- 🏗️ Layer: Tests
- 🔒 Invariant: Built reports are immutable snapshots; audit hooks produce append-only event traces.
- ƒ _terminal_run (
Function)[TRIVIAL]- 📝 Build deterministic terminal run fixture for report snapshot tests.
- ƒ test_report_builder_sets_immutable_snapshot_flag (
Function)[TRIVIAL]- 📝 Ensure generated report payload is marked immutable and persisted as snapshot.
- ƒ test_repository_rejects_report_overwrite_for_same_report_id (
Function)[TRIVIAL]- 📝 Define immutability contract that report snapshots cannot be overwritten by same identifier.
- ƒ test_audit_hooks_emit_append_only_event_stream (
Function)[TRIVIAL]- 📝 Verify audit hooks emit one event per action call and preserve call order.
- 📦 test_candidate_manifest_services (
Module)- 📝 Test lifecycle and manifest versioning for release candidates.
- 🏗️ Layer: Tests
- ƒ db_session (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_candidate_lifecycle_transitions (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_manifest_versioning_and_immutability (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ _valid_artifacts (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_register_candidate_rejects_duplicate_candidate_id (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_register_candidate_rejects_malformed_artifact_input (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_register_candidate_rejects_empty_artifact_set (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_manifest_service_rebuild_creates_new_version (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_manifest_service_existing_manifest_cannot_be_mutated (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- ƒ test_manifest_service_rejects_missing_candidate (
Function)[TRIVIAL]- 📝 Auto-detected function (orphan)
- 📦 backend.tests.services.clean_release.test_policy_resolution_service (
Module)- 📝 Verify trusted policy snapshot resolution contract and error guards.
- 🏗️ Layer: Tests
- 🔒 Invariant: Resolution uses only ConfigManager active IDs and rejects runtime override attempts.
- 🔗 DEPENDS_ON ->
backend.src.services.clean_release.policy_resolution_service - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.repository - 🔗 DEPENDS_ON ->
backend.src.services.clean_release.exceptions - ƒ _config_manager (
Function)[TRIVIAL]- 📝 Build deterministic ConfigManager-like stub for tests.
- ƒ test_resolve_trusted_policy_snapshots_missing_profile (
Function)[TRIVIAL]- 📝 Ensure resolution fails when trusted profile is not configured.
- ƒ test_resolve_trusted_policy_snapshots_missing_registry (
Function)[TRIVIAL]- 📝 Ensure resolution fails when trusted registry is not configured.
- ƒ test_resolve_trusted_policy_snapshots_rejects_override_attempt (
Function)[TRIVIAL]- 📝 Ensure runtime override attempt is rejected even if snapshots exist.
- 📦 backend.tests.services.clean_release.test_approval_service (
Module)- 📝 Define approval gate contracts for approve/reject operations over immutable compliance evidence.
- 🏗️ Layer: Tests
- 🔒 Invariant: Approval is allowed only for PASSED report bound to candidate; duplicate approve and foreign report must be rejected.
- ƒ _seed_candidate_with_report (
Function)[TRIVIAL]- 📝 Seed candidate and report fixtures for approval gate tests.
- ƒ test_approve_rejects_blocked_report (
Function)[TRIVIAL]- 📝 Ensure approve is rejected when latest report final status is not PASSED.
- ƒ test_approve_rejects_foreign_report (
Function)[TRIVIAL]- 📝 Ensure approve is rejected when report belongs to another candidate.
- ƒ test_approve_rejects_duplicate_approve (
Function)[TRIVIAL]- 📝 Ensure repeated approve decision for same candidate is blocked.
- ƒ test_reject_persists_decision_without_promoting_candidate_state (
Function)[TRIVIAL]- 📝 Ensure reject decision is immutable and does not promote candidate to APPROVED.
- ƒ test_reject_then_publish_is_blocked (
Function)[TRIVIAL]- 📝 Ensure latest REJECTED decision blocks publication gate.
- 📦 backend.tests.services.clean_release.test_compliance_execution_service (
Module)- 📝 Validate stage pipeline and run finalization contracts for compliance execution.
- 🏗️ Layer: Tests
- 🔒 Invariant: Missing manifest prevents run startup; failed execution cannot finalize as PASSED.
- ƒ _seed_with_candidate_policy_registry (
Function)[TRIVIAL]- 📝 Build deterministic repository state for run startup tests.
- ƒ test_run_without_manifest_rejected (
Function)[TRIVIAL]- 📝 Ensure compliance run cannot start when manifest is unresolved.
- ƒ test_task_crash_mid_run_marks_failed (
Function)[TRIVIAL]- 📝 Ensure execution crash conditions force FAILED run status.
- ƒ test_blocked_run_finalization_blocks_report_builder (
Function)[TRIVIAL]- 📝 Ensure blocked runs require blocking violations before report creation.